JavaScript API Reference for Oracle ADF Faces

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

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

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

public class AdfDhtmlMenuBarPeer
extends AdfRichUIPeer

Peer Implementation for menu bar

Field Summary

private Object	_childContainers
private Object	_isOverflowSupported
private Object	_overflowContainer

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

AdfDhtmlMenuBarPeer() Peer Implementation for menu bar

Method Summary

protected Object	ChildVisibilityChanged(Object childComponent, Object childDomElement, Object childVisible) Called when the visibility of a child component changes if the peer has overridden needsChildVisibilityChanges to return true.
protected Object	ComponentRemoved(AdfUIComponent component) Handles the removal of a component.
private Object	_createOverflowElement(Object element) Create and return a single html overflow element for the provided element data.
public AdfUIComponent	getDescendantComponents(AdfUIComponent component, Array<AdfUIComponent> children) Returns an array of descendant (child) components for this component.
protected Number	GetMinimumWidth() Returns the minimum width of a menuBar.
protected Number	GetPreferredWidth() Calculates the preferred width of the menuBar.
private HTMLElement	_getStretchElement() Finds the DOM element for the stretched component.
private Object	_handleArrowKeys(Object keyCode, Object componentEvent) Handler for left/right arrow key events.
protected Object	HandleComponentKeyDown(Object componentEvent) Component keyboard key down event handler
protected Object	HandleComponentKeyPress(Object componentEvent) Component keyboard key press event handler
protected Object	HandleComponentKeyUp(Object componentEvent) Component keyboard key up event handler.
private static Object	_handleMenuBarItemAccessKeys(Object component, Object componentEvent) Handle menu bar item access keys A root level (on the menuBar) commandMenuItem or menu may have an access key assigned.
protected Object	InitDomElement(Object component, Object domElement) Initialize the associated domElement when the peer is created.
protected static Object	InitSubclass()
private Object	_moveHighlightToNextBarItem(Object componentEvent) Moves the highlight (selection) to the next (right) bar item.
private Object	_moveHighlightToPreviousBarItem(Object componentEvent) Moves the highlight (selection) to the previous (left) bar item.
public Object	needsChildVisibilityChanges(Object component) Test whether the peer wants to be notified if the visibility of one of its children changes.
public Object	needsResizeNotify(Object component) We need resize notification.
protected Object	ResizeNotify(Object oldWidth, Object oldHeight, Object newWidth, Object newHeight) Resize notification callback - we perform geometry management here
private Object	_reStretch() If there is a stretch element in the menuBar, reapply it to it's maximum size
private Object	_unStretch() If there is a stretch element in the menuBar, remove its assigned width.
public Object	updateScrollIconsState() MenuBar (as apposed to Menu) does not have scroll icons, so calls to this method (which originate from MenuBar overflow) are ignored.

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

addComponentEventHandlers, addComponentPropertyChanges, addComponentPropertyGetters, addDomEventHandlers, addEventHandlerToDomInstance, addSuppressedPPRAttributes, bind, BindToComponent, cancelAllPopups, cancelPopup, ComponentInlineStyleChanged, ComponentPropertyChanged, componentRemoved, ComponentStyleClassChanged, ComponentVisibleChanged, ConvertClientIdToLocator, convertLocatorToClientId, CreateDraggableNode, createPeerClass, createSubId, CreateSubId, DefaultInitClass, DispatchComponentEvent, domReplaceNotify, DomReplaceNotify, focus, Focus, getAbsoluteId, getAbsoluteLocator, getAccessibleName, GetAccessibleName, getAllPopups, getComponent, GetComponent, GetComponentId, getComponentParent, getComponentProperty, GetComponentVisible, 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, MessageNotify, messageShow, MessageShow, PopupClosed, processPushData, ProcessPushData, registerKeyStroke, replaceDomElement, ReplaceDomElement, 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

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

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

Field Detail

_childContainers

private Object _childContainers

_isOverflowSupported

private Object _isOverflowSupported

_overflowContainer

private Object _overflowContainer

Constructor Detail

AdfDhtmlMenuBarPeer

public AdfDhtmlMenuBarPeer()

Peer Implementation for menu bar

Method Detail

ChildVisibilityChanged

protected Object ChildVisibilityChanged(Object childComponent,
Object childDomElement,
Object childVisible)

Called when the visibility of a child component changes if the peer has overridden needsChildVisibilityChanges to return true. The peer can use the child's component, domElement, and new visibility parameters to determine whether it needs to handle the visibility change rather than letting the default implementation of hiding or showing the child. If the peer will handle the change (often by marking itself as needing to be redrawn, it should perform whatever work is necessary and return true from this method.

Overrides of this method should be aware that when this method is called, the child component's peer may no longer be bound to the child component (for example, if both the child and parent component peers are the same instance).

Overrides of this method should use the childDomElement parameter to determine whether the passed in childComponent is actually a direct descendant of the parent component.

Parameters:

childComponent
childDomElement
childVisible

Return:

Object

Overrides:

AdfRichUIPeer.ChildVisibilityChanged(Object, Object, Object)

ComponentRemoved

protected Object ComponentRemoved(AdfUIComponent component)

Handles the removal of a component.

Parameters:

component

-

The component that was removed.

Return:

Object

Overrides:

AdfUIPeer.componentRemoved(AdfUIComponent)

_createOverflowElement

private Object _createOverflowElement(Object element)

Create and return a single html overflow element for the provided element data.

Parameters:

element

Return:

Object

getDescendantComponents

public AdfUIComponent getDescendantComponents(AdfUIComponent component,
Array<AdfUIComponent> children)

Returns an array of descendant (child) components for this component. Overwritten to include items in overflow as well.

Parameters:

component	-	this component
children	-	array to store child components in. Descendent components will be added to the end of the array. This param is optional, if not passed in an array will be created.

Return:

AdfUIComponent - array of child components, may be empty

Overrides:

AdfUIPeer.getDescendantComponents(AdfUIComponent, Array<AdfUIComponent>)

GetMinimumWidth

protected Number GetMinimumWidth()

Returns the minimum width of a menuBar. Called by toolbox peer.

Return:

Number - The minimum width.

GetPreferredWidth

protected Number GetPreferredWidth()

Calculates the preferred width of the menuBar. This is the width of the menuBar when it doesn't have overflow or stretching. This is used by the toolbox for overflowing purposes.

Return:

Number - The preferred width.

_getStretchElement

private HTMLElement _getStretchElement()

Finds the DOM element for the stretched component.

Return:

HTMLElement - The element

_handleArrowKeys

private Object _handleArrowKeys(Object keyCode,
Object componentEvent)

Handler for left/right arrow key events.

Parameters:

keyCode
componentEvent

Return:

Object

HandleComponentKeyDown

protected Object HandleComponentKeyDown(Object componentEvent)

Component keyboard key down event handler

Parameters:

componentEvent

-

the component event invoked by key down

Return:

Object

HandleComponentKeyPress

protected Object HandleComponentKeyPress(Object componentEvent)

Component keyboard key press event handler

Parameters:

componentEvent

-

the component event invoked by key press

Return:

Object

HandleComponentKeyUp

protected Object HandleComponentKeyUp(Object componentEvent)

Component keyboard key up event handler.

Parameters:

componentEvent

-

the component event invoked by key up

Return:

Object

_handleMenuBarItemAccessKeys

private static Object _handleMenuBarItemAccessKeys(Object component,
Object componentEvent)

Handle menu bar item access keys A root level (on the menuBar) commandMenuItem or menu may have an access key assigned. The way menu-type access keys work is that while your focus is in a menu or menuBar, a press of an access key (without any of the normal modifiers like shift-alt) will bring focus to that menu/menuBar item. This method checks its children for an access key match and handles it.

Parameters:

component	-	the menuBar component
componentEvent	-	the key up component event

Return:

Object

InitDomElement

protected Object InitDomElement(Object component,
Object domElement)

Initialize the associated domElement when the peer is created. Stateless peers are not bound at the time that this method is called.

Parameters:

component
domElement

Return:

Object

Overrides:

AdfRichUIPeer.InitDomElement(AdfUIComponent, Object)

InitSubclass

protected static Object InitSubclass()

Return:

Object

_moveHighlightToNextBarItem

private Object _moveHighlightToNextBarItem(Object componentEvent)

Moves the highlight (selection) to the next (right) bar item.

Parameters:

componentEvent

Return:

Object

_moveHighlightToPreviousBarItem

private Object _moveHighlightToPreviousBarItem(Object componentEvent)

Moves the highlight (selection) to the previous (left) bar item.

Parameters:

componentEvent

Return:

Object

needsChildVisibilityChanges

public Object needsChildVisibilityChanges(Object component)

Test whether the peer wants to be notified if the visibility of one of its children changes. If a peer overrides this method to return true, the peer's ChildVisibilityChanged method will be called.

The peer is not bound when this method is called. Peers with complicated logic to determine whether they need to be informed of child visibility changes should return true from this method and place their logic inside of their ChildVisibilityChanged override.

Parameters:

component

Return:

Object

Overrides:

AdfRichUIPeer.needsChildVisibilityChanges(AdfUIComponent)

needsResizeNotify

public Object needsResizeNotify(Object component)

We need resize notification.

Parameters:

component

Return:

Object

Overrides:

AdfUIPeer.needsResizeNotify(Object)

ResizeNotify

protected Object ResizeNotify(Object oldWidth,
Object oldHeight,
Object newWidth,
Object newHeight)

Resize notification callback - we perform geometry management here

Parameters:

oldWidth
oldHeight
newWidth
newHeight

Return:

Object

Overrides:

AdfUIPeer.resizeNotify(Object, Object, Object, Object, Object)

_reStretch

private Object _reStretch()

If there is a stretch element in the menuBar, reapply it to it's maximum size

Return:

Object

_unStretch

private Object _unStretch()

If there is a stretch element in the menuBar, remove its assigned width.

Return:

Object

updateScrollIconsState

public Object updateScrollIconsState()

MenuBar (as apposed to Menu) does not have scroll icons, so calls to this method (which originate from MenuBar overflow) are ignored.

Return:

Object

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