JavaScript API Reference for Oracle ADF Faces

SUMMARY: FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

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

Warning:

• This is an unsupported, internal implementation class.
• Use an API class that might provide equivalent functionality instead.
• This class will change without notice.
• It is not recommended that you use anything in this class.

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

Peer for the inputComboboxListOfValues component.

Field Summary

private static Object	_CONTAINER_DIALOG_SUBID
private static Object	_DEPRESSED_STYLE_CLASS
private static Object	_DROPDOWN_CONTENT_ID
private static Object	_DROPDOWN_ICON_ID
private static Object	_MRU_ROW_SEPARATOR
private static Object	_POPUP_SEARCH_SUBID
private static Object	_POPUP_SUBID
private static Object	_SCREENREADER_DIALOG_SUBID
private static Object	_SHOWN

Fields inherited from oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlEditableValuePeer

ComponentLabelChanged

Fields inherited from oracle.adf.view.js.laf.rich.AdfRichUIPeer

addComponentPropertyChanges, addComponentPropertyGetters, BUSY_STYLECLASS, DISABLED_STYLECLASS, DRAG_SOURCE_STYLECLASS, DROP_TARGET_STYLECLASS, FOCUS_TARGET_STYLECLASS, HOVER_TARGET_STYLECLASS, READONLY_STYLECLASS

Fields inherited from oracle.adf.view.js.base.AdfObject

constructor, superclass

Fields inherited from org.ecmascript.object.Object

prototype

Constructor Summary

public

AdfDhtmlInputComboboxListOfValuesPeer() Peer for the inputComboboxListOfValues component.

Method Summary

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.
private static Object	_createPopupSubId(Object clientId) convenience funtion to return the dropDownContent subid
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
private Object	_getRowKeyAndRowForEvent(Object domEvent, Object domElement, Object rootDomElement) Convenience function to get the rowkey of the selected row
protected Object	HandleComponentAction(Object componentEvent) Action Event handler for the click of Search link in the drop down
protected Object	HandleComponentClick(Object componentEvent) Handler for the click event of drop-down icon
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.
protected Object	HandleComponentKeyDown(Object componentEvent)
protected Object	HandleComponentKeyUp(Object componentEvent) Intercept the ctrl+alt+w key combination and activate an associated notewindow if one is open.
protected Object	HandleComponentPopupClosed(Object componentEvent) Handler for the popup closed event, sets the _shown attribute to false on lov component when the dropdown popup is closed
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
protected static Object	InitSubclass() Registers component onclick handler and the action handler for the Search commandlink in drop down content
private Object	_isInDropDownTableClick(Object elem)
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.
private static Object	_returnTableSelection(Object table, Object lov) sends the return event to the server.
public Object	showDropDown(Object clientId) Convenience function to show the drop down
protected Object	VetoShowNoteWindow(Object component) veto showing note window.

Methods inherited from oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlInputListOfValuesBasePeer

AutoTab, FocusInputElement, HandleComponentDblClick, HandleComponentKeyPress, HandleComponentSelection, HandleDomChange, IsKeyEventInInput, IsLovPopupVisible, IsNoteWindowVisible, SetDisplayValue, ShowNoteWindow, ShowPopupDialog, showToolbarPopup

Methods inherited from oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlInputBasePeer

GetSubmittedValue, HandleComponentBlur, HandleComponentFocus, RunValidation, ShouldShowHint, __simulateBlur, VetoBlurValidation

Methods inherited from oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlEditableValuePeer

autoSubmit, BindToComponent, ComponentChanged, __componentLabelChanged, ComponentSubmittedValueChanged, disableBrowserAutoComplete, Focus, GetComponentLabel, GetComponentSubmittedValue, GetComponentValue, GetContentNode, GetContentNodeId, GetDisplayValue, GetNoteWindowAlignmentHint, GetNoteWindowAlignmentNode, GetValidatorHints, HideNoteWindow, InitDomElement, IsInitialized, MessageNotify, MessageShow, ShowNoteWindowMouseOver, StashOldValue, Validate, ValidateAndStashNewValue, ValidateIfStashedOldValue, WasSubmitted

Methods inherited from oracle.adfinternal.view.js.laf.dhtml.rich.AdfDhtmlValuePeer

ComponentValueChanged, getConvertedObject, getConvertedValue, getFormatHint, GetNullDefault, isEmpty

Methods inherited from oracle.adf.view.js.laf.rich.AdfRichUIPeer

addComponentEventHandlers, addComponentPropertyChanges, addComponentPropertyGetters, addDomEventHandlers, addEventHandlerToDomInstance, addSuppressedPPRAttributes, bind, cancelAllPopups, cancelPopup, ChildVisibilityChanged, ComponentInlineStyleChanged, ComponentPropertyChanged, componentRemoved, ComponentRemoved, ComponentStyleClassChanged, ComponentVisibleChanged, ConvertClientIdToLocator, convertLocatorToClientId, CreateDraggableNode, createPeerClass, createSubId, CreateSubId, DefaultInitClass, DispatchComponentEvent, domReplaceNotify, DomReplaceNotify, focus, getAbsoluteId, getAbsoluteLocator, getAccessibleName, GetAccessibleName, getAllPopups, getComponent, GetComponent, GetComponentId, getComponentParent, getComponentProperty, GetComponentVisible, getDescendantComponents, getDomContentElement, getDomContentElementForComponent, GetDomContentElementForNode, getDomDocument, getDomElement, getDomElementForComponent, getDomNode, GetDomNodeForCommentComponent, getDomNodeForComponent, getDragOverFeedback, GetDragOverFeedback, getDragTransferable, GetDragTransferable, getFirstAncestorComponent, getInlineEditor, GetInlineEditor, getInlineStyleProperty, getLocatorByDomElement, getPagePosition, getPopupWindow, getReadyState, GetReadyState, GetRichResourceURL, getSubIdDomElement, GetSubIdDomElement, hideAllPopups, hidePopup, Init, InitClass, initialize, isActive, isInActiveHeirarchy, isPopupVisible, messageNotify, messageShow, needsChildVisibilityChanges, PopupClosed, processPushData, ProcessPushData, registerKeyStroke, replaceDomElement, ReplaceDomElement, resizeNotify, ResizeNotify, scrollIntoView, ScrollIntoView, setBusy, SetBusy, setInlineStyleProperty, showContextMenu, showPopup, TruncateClientId, TruncateClientIdOnceImpl, UnbindFromComponent, unregisterKeyStroke, visitChildren

Methods inherited from oracle.adf.view.js.base.AdfUIPeer

getDefaultDragRecognizer, getParentPeer, initiateDrag, isVisible, needsResizeNotify

Methods inherited from oracle.adf.view.js.base.AdfObject

adopt, clone, createCallback, createInitializedObject, createSubclass, ensureClassInitialization, equals, getClass, GetLazyArrayProperty, GetLazyMapProperty, getTypeName, toDebugString, toString

Field Detail

_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

_SHOWN

private static Object _SHOWN

Overrides:

AdfDhtmlInputListOfValuesBasePeer._SHOWN

Constructor Detail

AdfDhtmlInputComboboxListOfValuesPeer

public AdfDhtmlInputComboboxListOfValuesPeer()

Peer for the inputComboboxListOfValues component.

Method Detail

_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)

HandleComponentPopupClosed

protected Object HandleComponentPopupClosed(Object componentEvent)

Handler for the popup closed event, sets the _shown attribute to false on lov component when the dropdown popup is closed

Parameters:

componentEvent

Return:

Object

Overrides:

AdfDhtmlInputListOfValuesBasePeer.HandleComponentPopupClosed(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)

SUMMARY: FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD