Object AMLGestureEvent

The AMLGestureEvent class encapsulates information about a multi-touch gesture. AMLGestureEvent objects are high-level events that encapsulate the low-level AMLTouchEvent objects. Both AMLGestureEvent and AMLTouchEvent events are sent during a multi-touch sequence. Gesture events contain scaling and rotation information allowing gestures to be combined, if supported by the platform. If not supported, one gesture ends before another starts. Listen for AMLGestureEvent events if you want to respond to gestures only, not process the low-level AMLTouchEvent objects.

Extends

AMLUIEvent

Members Table

The following table lists the members exposed by the AMLGestureEvent object.

Show inherited members (marked with *)

Show: Properties Methods

Attribute Readonly Description Property Type Readonly Description $pseudoTarget * HTMLElement false Keeps the reference to pseudo element where event originated. altKey Boolean true If true, the alt key is pressed; otherwise, it is not. bubbles * Boolean true Used to indicate whether or not an event is a bubbling event. cancelable * Boolean true Used to indicate whether or not an event can have its default action prevented. clientX Number true The x-coordinate of the event’s location relative to the window’s viewport. clientY Number true The y-coordinate of the event’s location relative to the window’s viewport. ctrlKey Boolean true If true, the control key is pressed; otherwise, it is not. currentTarget * AMLNode true Used to indicate the EventTarget whose EventListeners are currently being processed. This is particularly useful during capturing and bubbling. defaultPrevented * Boolean true Used to indicate whether preventDefault() has been called for this event. detail * Number false Specifies some detail information about the Event, depending on the type of event. eventPhase * Number true Used to indicate which phase of event flow is currently being evaluated. metaKey Boolean true If true, the meta key is pressed; otherwise, it is not. namespaceURI * String true The namespace URI associated with this event at initialization time, or null if it is unspecified. rotation Number true The delta rotation since the start of an event, in degrees, where clockwise is positive and counter-clockwise is negative. The initial value is 0.0. scale Number true The distance between two fingers since the start of an event, as a multiplier of the initial distance. The initial value is 1.0. If less than 1.0, the gesture is pinch close (to zoom out). If greater than 1.0, the gesture is pinch open (to zoom in). screenX Number true The x-coordinate of the event’s location in screen coordinates. screenY Number true The y-coordinate of the event’s location in screen coordinates. shiftKey Boolean true If true, the shift key is pressed; otherwise, it is not. target * AMLNode true Used to indicate the EventTarget to which the event was originally dispatched. target AMLElement true The target of this gesture. timeStamp * TimeStamp true Used to specify the time (in milliseconds relative to the epoch) at which the event was created. type * String true The name of the event (case-insensitive). The name must be an XML name. view * Object false The view attribute identifies the AbstractView from which the event was generated. Method Returns Description initEvent * Void The initEvent method is used to initialize the value of an Event created through the DocumentEvent interface. Sytaxis: object.initEvent(sEventType, bCanBubble, bCancelable) Arguments: Name Type O/R Description sEventType String Required Specifies the event type. bCanBubble Boolean Required Specifies whether or not the event can bubble. bCancelable Boolean Required Specifies whether or not the event's default action can be prevented. initGestureEvent Void Initializes attributes of a AMLGestureEvent object. Sytaxis: object.initGestureEvent(sEventType, bCanBubble, bCancelable, oView, nDetail, nScreenX, nScreenY, nClientX, nClientY, bCtrlKey, bAltKey, bShiftKey, bMetaKey, oTarget, nScale, nRotation) Arguments: Name Type O/R Description sEventType String Required The type of event that occurred. bCanBubble Boolean Required Indicates whether an event can bubble. If true, the event can bubble; otherwise, it cannot. bCancelable Boolean Required Indicates whether an event can have its default action prevented. If true, the default action can be prevented; otherwise, it cannot. oView Object Required The view (DOM window) in which the event occurred. nDetail Number Required Specifies some detail information about the event depending on the type of event. nScreenX Number Required The x-coordinate of the event’s location in screen coordinates. nScreenY Number Required The y-coordinate of the event’s location in screen coordinates. nClientX Number Required The x-coordinate of the event’s location relative to the window’s viewport. nClientY Number Required The y-coordinate of the event’s location relative to the window’s viewport. bCtrlKey Boolean Required If true, the control key is pressed; otherwise, it is not. bAltKey Boolean Required If true, the alt key is pressed; otherwise, it is not. bShiftKey Boolean Required If true, the shift key is pressed; otherwise, it is not. bMetaKey Boolean Required If true, the meta key is pressed; otherwise, it is not. oTarget AMLElement Required The target of this gesture. nScale Number Required The distance between two fingers since the start of an event as a multiplier of the initial distance. The initial value is 1.0. If less than 1.0, the gesture is pinch close (to zoom out). If greater than 1.0, the gesture is pinch open (to zoom in). nRotation Number Required The delta rotation since the start of an event, in degrees, where clockwise is positive and counter-clockwise is negative. The initial value is 0.0. initUIEvent * Void The initUIEvent method is used to initialize the value of a UIEvent object. Sytaxis: object.initUIEvent(sEventType, bCanBubble, bCancelable, oView, nDetail) Arguments: Name Type O/R Description sEventType String Required Specifies the event type. bCanBubble Boolean Required Specifies whether or not the event can bubble. bCancelable Boolean Required Specifies whether or not the event's default action can be prevented. oView Object Required Specifies view. This value may be null. nDetail Number Required Specifies detail. preventDefault * Void If an event is cancelable, the preventDefault method is used to signify that the event is to be canceled, meaning any default action normally taken by the implementation as a result of the event will not occur. Sytaxis: object.preventDefault() stopImmediatePropagation * Void Prevents other event listeners from being triggered and, unlike stopPropagation() its effect is immediate Sytaxis: object.stopImmediatePropagation() stopPropagation * Void The stopPropagation method is used prevent further propagation of an event during event flow. The event will complete dispatch to all listeners on the current EventTarget before event flow stops. This method may be used during any stage of event flow. Sytaxis: object.stopPropagation() Event B C Interface Description Pseudo-class Description Constant Value Description

Remarks

Events of that type:

• gesturestart
• gesturechange
• gestureend