OracleJavaScript API Reference for Oracle ADF Faces

 

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

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

Warning:

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
_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
_SUB_ID_MAP
inputComboboxListOfValues component publishes the following sub ids [External Subid --> Internal Client SubId]:- 1.


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, 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
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.
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

FocusInputElement, HandleComponentDblClick, HandleComponentKeyPress, HandleComponentPopupClosed, 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, __componentLabelChanged, ComponentSubmittedValueChanged, ComponentTextChanged, 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, 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, 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


_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

_SUB_ID_MAP

private static Object _SUB_ID_MAP

inputComboboxListOfValues component publishes the following sub ids [External Subid --> Internal Client SubId]:- 1. [content --> content] - inputColor content

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

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

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

 

Generated on 2009.04.27 01:06 UTC
Copyright (c) 1998, 2008, Oracle and/or its affiliates. All rights reserved.