JavaScript API Reference for Oracle ADF Faces

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

oracle.adfinternal.view.js.agent.safari
Class AdfSafariTouchContextMenuManager

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.agent.AdfTouchContextMenuManager
               |
               +--oracle.adfinternal.view.js.agent.safari.AdfSafariTouchContextMenuManager

public class AdfSafariTouchContextMenuManager
extends AdfTouchContextMenuManager

See also:

AdfSafariMobileAgent.createContextMenuEventGenerator()

Field Summary

private static Object

_LONG_TOUCH_TIMEOUT Constant that defines the number of milliseconds that defines a long touch, tap+hold.

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

constructor, superclass

Fields inherited from org.ecmascript.object.Object

prototype

Constructor Summary

public

AdfSafariTouchContextMenuManager()

Method Summary

public AdfComponentEvent	deriveContextMenuEvent(AdfComponentEvent componentEvent) Called by the {@link AdfPage} service when redistributing native events into component events.
public void	dispose() Tear down the instance of this manager.
protected void	Init() Initial setup of manager state.
private void	_longTouchHandler(AdfComponentTouchEvent componentEvent) Queue the contextMenu event following a long-touch timeout period.
private void	_longTouchTouchEndHandler() Set a flag that the startTouch has reached the period that defines the long touch.

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

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

Field Detail

_LONG_TOUCH_TIMEOUT

private static Object _LONG_TOUCH_TIMEOUT

Constant that defines the number of milliseconds that defines a long touch, tap+hold.

Constructor Detail

AdfSafariTouchContextMenuManager

public AdfSafariTouchContextMenuManager()

Method Detail

deriveContextMenuEvent

public AdfComponentEvent deriveContextMenuEvent(AdfComponentEvent componentEvent)

Called by the AdfPage service when redistributing native events into component events. Each component event will be passed into this function. The context menu event is generated from the "tap+hold" or "tap+hold+tap-up" gestures, depending on if a conflict with drag-and-drop exists. If both drag-and-drop and contextMenu are competing for the long-touch, queue the contextMenu event on "tap+hold+tap-up". Otherwise, queue the context menu event at the end of the long-touch, "tap+hold". The start touch resets the critera for deriving the contextMenu event. The user must hold the tap AdfComponentTouchEvent.TOUCH_START_EVENT_TYPE for one second without movement AdfComponentTouchEvent.TOUCH_MOVE_EVENT_TYPE to meet the condition for a "long-touch". In addtion, the tap must only be a single fingure gesture.

Parameters:

componentEvent

-

derives a contextMenu event from the componentEvent

Return:

AdfComponentEvent - component event of type AdfComponentEvent.CONTEXT_MENU_EVENT_TYPE or null

See also:

AdfAgent.createContextMenuEventGenerator()

Overrides:

AdfTouchContextMenuManager.deriveContextMenuEvent(AdfComponentEvent)

dispose

public void dispose()

Tear down the instance of this manager.

Return:

void - null

Overrides:

AdfTouchContextMenuManager.dispose()

Init

protected void Init()

Initial setup of manager state.

Return:

void - null

Overrides:

AdfObject.Init()

_longTouchHandler

private void _longTouchHandler(AdfComponentTouchEvent componentEvent)

Queue the contextMenu event following a long-touch timeout period.

Parameters:

componentEvent

-

"touchStart" event that has met the criteria of a long-touch

Return:

void - null

See also:

"#getComponentEvent"

_longTouchTouchEndHandler

private void _longTouchTouchEndHandler()

Set a flag that the startTouch has reached the period that defines the long touch. Set a flag that is used to queue a contextMenu event on touchEnd provided a touchMove is not fired before the touchEnd event.

Return:

void - null

See also:

"#getComponentEvent"

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