HTML5 Touch Event

This interface defines the touchstart, touchend, touchmove, touchenter, touchleave, and touchcancel event types.


Supported Platform(s)

- BlackBerry OS 6.0+
- BlackBerry PlayBook 1.0+
- BlackBerry 10
View Supported Platform Table
APIBB5.0BB6.0BB7.0PB1.0PB2.0BB10Ripple
initTouchEvent   Y Y Y Y Y 
altKey   Y Y Y Y Y 
changedTouches   Y Y Y Y Y 
ctrlKey   Y Y Y Y Y 
metaKey   Y Y Y Y Y 
relatedTarget   Y Y Y Y Y 
shiftKey   Y Y Y Y Y 
targetTouches   Y Y Y Y Y 
touches   Y Y Y Y Y 

Configuration Document Settings

To use all of the API described for this object, you must ensure the following settings are in your configuration document:

This API does not require a <feature> element to be declared in the configuration document of your BlackBerry WebWorks Application.

Permission Elements (PlayBook and BlackBerry 10+)
This API does not require a <permission> element to be declared in the configuration document of your BlackBerry WebWorks Application.

Functions

Boolean initTouchEvent

Functions

readonly Boolean initTouchEvent (type : String, canBubble : Boolean, cancelable : Boolean, view : Window, detail : Number, ctrlKey : Boolean, altKey : Boolean, shiftKey : Boolean, metaKey : Boolean, touches : TouchList, targetTouches : TouchList, changedTouches : TouchList)


initializes a TouchEvent created through the DocumentEvent interface.


Supported Platforms
 - BlackBerry OS 6.0+
 - BlackBerry PlayBook 1.0+
 - BlackBerry 10


Parameters
type
canBubble
cancelable
view
detail
ctrlKey
altKey
shiftKey
metaKey
touches
targetTouches
changedTouches

Properties

readonly Boolean altKey


true if the alt (Alternate) key modifier is activated; otherwise false


Supported Platforms
 - BlackBerry OS 6.0+
 - BlackBerry PlayBook 1.0+
 - BlackBerry 10

readonly TouchList changedTouches


a list of Touches for every point of contact which contributed to the event


Supported Platforms
 - BlackBerry OS 6.0+
 - BlackBerry PlayBook 1.0+
 - BlackBerry 10

readonly Boolean ctrlKey


true if the ctrl (Control) key modifier is activated; otherwise false


Supported Platforms
 - BlackBerry OS 6.0+
 - BlackBerry PlayBook 1.0+
 - BlackBerry 10

readonly Boolean metaKey


if the meta (Meta) key modifier is activated; otherwise false. On some platforms this attribute may map to a differently-named key


Supported Platforms
 - BlackBerry OS 6.0+
 - BlackBerry PlayBook 1.0+
 - BlackBerry 10

readonly EventTarget relatedTarget


identifies a secondary {EventTarget} related to a touch event. This attribute is used with the touchenter event to indicate the {EventTarget} the touch point exited, and with the touchleave event to indicate the {EventTarget} the touch point entered. For other event types, this attribute must be null.


Supported Platforms
 - BlackBerry OS 6.0+
 - BlackBerry PlayBook 1.0+
 - BlackBerry 10

readonly Boolean shiftKey


true if the shift (Shift) key modifier is activated; otherwise false


Supported Platforms
 - BlackBerry OS 6.0+
 - BlackBerry PlayBook 1.0+
 - BlackBerry 10

readonly TouchList targetTouches


a list of Touches for every point of contact currently touching the surface, which started on the same target


Supported Platforms
 - BlackBerry OS 6.0+
 - BlackBerry PlayBook 1.0+
 - BlackBerry 10

readonly TouchList touches


a list of Touches for every point of contact currently touching the surface


Supported Platforms
 - BlackBerry OS 6.0+
 - BlackBerry PlayBook 1.0+
 - BlackBerry 10

Documentation generated by JsDoc Toolkit 2.4.0 on Sun Dec 30 2012 18:15:45 GMT-0500 (EST)