nsIDOMMouseEvent
Last changed in Gecko 1.9.1 (Firefox 3.5 / Thunderbird 3.0 / SeaMonkey 2.0)The nsIDOMSimpleGestureEvent
interface is the datatype for all Mozilla-specific simple gesture events in the Document Object Model.
The following events are generated:
MozSwipeGesture - Generated when the user completes a swipe across across the input device.
MozMagnifyGestureStart - Generated when the user begins the magnify ("pinch") gesture. The "delta
" value represents the initial movement.
MozMagnifyGestureUpdate - Generated periodically while the user is continuing the magnify ("pinch") gesture. The "delta
" value represents the movement since the last MozMagnifyGestureStart or MozMagnifyGestureUpdate event.
MozMagnifyGesture - Generated when the user has completed the magnify ("pinch") gesture. If you only want to receive a single event when the magnify gesture is complete, you only need to hook this event and can safely ignore the MozMagnifyGestureStart and the MozMagnifyGestureUpdate events. The "delta
" value is the cumulative amount represented by the user's gesture.
MozRotateGestureStart - Generated when the user begins the rotation gesture. The "delta
" value represents the initial rotation.
MozRotateGestureUpdate - Generated periodically while the user is continuing the rotation gesture. The "delta
" value represents the rotation since the last MozRotateGestureStart or MozRotateGestureUpdate event.
MozRotateGesture - Generated when the user has completed the rotation gesture. If you only want to receive a single event when the rotation gesture is complete, you only need to hook this event and can safely ignore the MozRotateGestureStart and the MozRotateGestureUpdate events. The "delta
" value is the cumulative amount of rotation represented by the user's gesture.
MozTapGesture - Generated when the user executes a two finger tap gesture on the input device. Client coordinates contain the center point of the tap. (XXX Not implemented on Mac)
MozPressTapGesture - Generated when the user executes a press and tap two finger gesture (first finger down, second finger down, second finger up, first finger up) on the input device. Client coordinates contain the center pivot point of the action. (XXX Not implemented on Mac)
Default behavior:
Some operating systems support default behaviors for gesture events when they are not handled by the application. Consumers should use event.preventDefault() to prevent default behavior when consuming events.
Method overview
void initSimpleGestureEvent(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in nsIDOMAbstractView viewArg, in long detailArg, in long screenXArg, in long screenYArg, in long clientXArg, in long clientYArg, in boolean ctrlKeyArg, in boolean altKeyArg, in boolean shiftKeyArg, in boolean metaKeyArg, in unsigned short buttonArg, in nsIDOMEventTarget relatedTargetArg, in unsigned long directionArg, in double deltaArg); |
Attributes
Attribute | Type | Description |
delta | double | The delta value indicating how far the gesture moved. For update events, this indicates the movement since the previous update; for the The value is specified in degrees for rotation events (where positive values indicate clockwise rotation and negative values indicate counter-clockwise rotation). For magnify gestures, the units are implementation-specific; however, positive values indicate zooming in, and negative values indicate zooming out. Read only. Note: On Mac OS X, the units used for magnification gestures by the underlying operating system API are not documented at this time; typical values appear to be in the range 0.0 to 100.0, but currently you can only rely on the value being either positive or negative. On Windows, the units indicate the difference between the previous and current width between the two touch points, in pixels. |
direction | unsigned long | The direction in which the gesture moved. See Direction constants and Rotation constants on this page. Read only. |
Constants
Direction constants
Constant | Value | Description |
DIRECTION_UP | 1 | Upward swipe. |
DIRECTION_DOWN | 2 | Downward swipe. |
DIRECTION_LEFT | 4 | Leftward swipe. |
DIRECTION_RIGHT | 8 | Rightward swipe. |
Rotation constants
Constant | Value | Description |
ROTATION_COUNTERCLOCKWISE | 1 | Counter-clockwise rotation. |
ROTATION_CLOCKWISE | 2 | Clockwise rotation. |
Methods
initSimpleGestureEvent()
Initializes the gesture event.
void initSimpleGestureEvent( in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in nsIDOMAbstractView viewArg, in long detailArg, in long screenXArg, in long screenYArg, in long clientXArg, in long clientYArg, in boolean ctrlKeyArg, in boolean altKeyArg, in boolean shiftKeyArg, in boolean metaKeyArg, in unsigned short buttonArg, in nsIDOMEventTarget relatedTargetArg, in unsigned long directionArg, in double deltaArg );
Parameters
typeArg
canBubbleArg
cancelableArg
viewArg
detailArg
screenXArg
screenYArg
clientXArg
clientYArg
ctrlKeyArg
altKeyArg
shiftKeyArg
metaKeyArg
buttonArg
relatedTargetArg
directionArg
- The value to assign to the
direction
attribute. deltaArg
- The value to assign to the
delta
attribute.