JavaScript API Reference for Oracle ADF Faces

oracle.adfinternal.view.js.laf.dhtml.rich
Class AdfDhtmlInputComboboxListOfValuesPeer

org.ecmascript.object.Object
   |
   +--oracle.adf.view.js.base.AdfObject
         |
         +--oracle.adf.view.js.base.AdfUIPeer
               |
               +--oracle.adf.view.js.laf.rich.AdfRichUIPeer
                     |
                     +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlValuePeer
                           |
                           +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlEditableValuePeer
                                 |
                                 +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlInputBasePeer
                                       |
                                       +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlInputListOfValuesBasePeer
                                             |
                                             +--oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlInputComboboxListOfValuesPeer

public class AdfDhtmlInputComboboxListOfValuesPeer
extends AdfDhtmlInputListOfValuesBasePeer

_CONTAINER_DIALOG_SUBID

private static Object _CONTAINER_DIALOG_SUBID

_DEPRESSED_STYLE_CLASS

private static Object _DEPRESSED_STYLE_CLASS

_DROPDOWN_CONTENT_ID

private static Object _DROPDOWN_CONTENT_ID

_DROPDOWN_ICON_ID

private static Object _DROPDOWN_ICON_ID

_MRU_ROW_SEPARATOR

private static Object _MRU_ROW_SEPARATOR

_POPUP_SEARCH_SUBID

private static Object _POPUP_SEARCH_SUBID

_POPUP_SUBID

private static Object _POPUP_SUBID

Overrides:

AdfDhtmlInputListOfValuesBasePeer._POPUP_SUBID

_SCREENREADER_DIALOG_SUBID

private static Object _SCREENREADER_DIALOG_SUBID

AdfDhtmlInputComboboxListOfValuesPeer

public AdfDhtmlInputComboboxListOfValuesPeer()

Peer for the inputComboboxListOfValues component.

_clearDepressed

private Object _clearDepressed()

When the dropdown popup is hidden, this method is used to clean up the LOV's dropdown icon such that its depressed state is removed.

Return:

Object

_createPopupSubId

private static Object _createPopupSubId(Object clientId)

convenience funtion to return the dropDownContent subid

Parameters:

clientId

Return:

Object

FocusNextElement

protected Object FocusNextElement(Object node)

Sets the focus on the next component element which is a tabstop In screen reader mode the dropdown icon is tab stoppable so call focusNextTabStop twice to set the focus on the next component

Parameters:

node

Return:

Object

Overrides:

AdfDhtmlInputListOfValuesBasePeer.FocusNextElement(Object)

_getRowKeyAndRowForEvent

private Object _getRowKeyAndRowForEvent(Object domEvent,
                                        Object domElement,
                                        Object rootDomElement)

Convenience function to get the rowkey of the selected row

Parameters:

domEvent	-	native event
domElement	-	event source
rootDomElement	-	table dome node

Return:

Object - rowKey of the selected row

HandleComponentAction

protected Object HandleComponentAction(Object componentEvent)

Action Event handler for the click of Search link in the drop down

Parameters:

componentEvent

Return:

Object

HandleComponentClick

protected Object HandleComponentClick(Object componentEvent)

Handler for the click event of drop-down icon

Parameters:

componentEvent

Return:

Object

Overrides:

AdfDhtmlEditableValuePeer.HandleComponentClick(Object)

HandleComponentDialog

protected Object HandleComponentDialog(Object componentEvent)

handle the dialog events sent by the dialog which wraps the dropdown in screenReader mode.We just queue the returnPopupEvent here.

Parameters:

componentEvent

Return:

Object

Overrides:

AdfDhtmlInputListOfValuesBasePeer.HandleComponentDialog(Object)

HandleComponentKeyDown

protected Object HandleComponentKeyDown(Object componentEvent)

Parameters:

componentEvent

-

Key Down event Implements keyboard handling for eg:ALT+DOWN key will open the drop down panel

Return:

Object

Overrides:

AdfDhtmlInputListOfValuesBasePeer.HandleComponentKeyDown(Object)

HandleComponentKeyUp

protected Object HandleComponentKeyUp(Object componentEvent)

Intercept the ctrl+alt+w key combination and activate an associated notewindow if one is open. Note windows do not steal focus when shown. From the notewindow, the same sequence of keys will force navigation back to the owning input component.

Parameters:

componentEvent

-

Key Up event Implements keyboard handling for the peer, Enter key should fire validation

Return:

Object

Overrides:

AdfDhtmlEditableValuePeer.HandleComponentKeyUp(Object)

_handleDropDownTableClick

private Object _handleDropDownTableClick(Object componentEvent)

Handler for the selection of a row inside the drop down.Queue's the returnpopup event upon selection of a row

Parameters:

componentEvent

Return:

Object

InitSubclass

protected static Object InitSubclass()

Registers component onclick handler and the action handler for the Search commandlink in drop down content

Return:

Object

Overrides:

AdfDhtmlValuePeer.InitSubclass()

_isInDropDownTableClick

private Object _isInDropDownTableClick(Object elem)

Parameters:

elem

Return:

Object

LazyInitialize

protected Object LazyInitialize(Object component,
                                Object domElement)

We need to initialize the 'value' property before the user makes any changes so that we're not going to the peer for the 'value' property in the component.setProperty method. See explanation below. Background: 1. In component.setProperty if the old and new value of a property are equal the setProperty method returns without setting anything. This is to avoid unnecessary propertyChangeEvents. 2. We do not send down the 'value' property from the server, so the 'value' property starts out undefined. If a property is undefined then calls to get the current value will go to the peer. So initally calls to getValue() go to the peer's GetComponentValue() Issue: - Mostly component.setProperty will only be called after the user makes a change, and if the property is currently undefined the peer's property getter will be called for the 'old' value. The peer will then return the current value, which is the new changed value. - That means the 'old' value is the same as the new value, and so the property is not set (see point 1 above). - Therefore we need to initialize the 'value' property before the user makes any changes so that we're not going to the peer for the 'value' property in the component.setProperty method.

Parameters:

component
domElement

Return:

Object

Overrides:

AdfDhtmlEditableValuePeer.LazyInitialize(Object, Object)

_returnTableSelection

private static Object _returnTableSelection(Object table,
                                            Object lov)

sends the return event to the server.

Parameters:

table	-	AdfRichTable
lov	-	the comboLOV component

Return:

Object

showDropDown

public Object showDropDown(Object clientId)

Convenience function to show the drop down

Parameters:

clientId

Return:

Object

VetoShowNoteWindow

protected Object VetoShowNoteWindow(Object component)

veto showing note window. When the popup is shown don't show the note window

Parameters:

component

Return:

Object

Overrides:

AdfDhtmlEditableValuePeer.VetoShowNoteWindow(Object)