Action
Event
Result
On the shortcut bar, this action displays a tooltip that describes
the action that the icon represents.
touch the screen twice
quickly
net.rim.device.api.ui
.TouchGesture.TAP
On a web page, map, picture, or presentation attachment, this
action zooms in to the web page, map, picture, or presentation
attachment.
click (press) the screen
net.rim.device.api.ui
.TouchEvent.CLICK
This action invokes an action. For example, when users click an
item in a list, the screen that is associated with the item appears.
This action is equivalent to clicking the trackball or trackwheel.
On a map, picture, or presentation attachment, this action zooms
in to the map, picture, or presentation attachment. On a web
page, this action zooms in to the web page or follows a link.
slide a finger up or
down quickly on the
screen
net.rim.device.api.ui
.TouchGesture.SWIPE_NORTH
net.rim.device.api.ui
.TouchGesture.SWIPE_SOUTH
Sliding a finger up quickly displays the next screen. Sliding a
finger down quickly displays the previous screen.
When the keyboard appears, sliding a finger down quickly hides
the keyboard and displays the shortcut bar.
slide a finger to the left
or right quickly on the
screen
net.rim.device.api.ui
.TouchGesture.SWIPE_WEST
net.rim.device.api.ui
.TouchGesture.SWIPE_EAST
This action displays the next or previous picture or message, or
the next or previous day, week, or month in a calendar.
hold a finger on an
item
net.rim.device.api.ui
.TouchGesture.HOVER
Holding a finger on the progress bar while a song or video is
playing fast forwards or rewinds the song or video.
In a text field, this action displays an empty rectangle cursor to
help users position the cursor more accurately in a text field.
touch and drag an item
on the screen
net.rim.device.api.ui
.TouchEvent.MOVE
This action moves the content on the screen in the corresponding
direction. For example, when users touch and drag a menu item,
the list of menu items moves in the same direction.
Development Guide
Touch screen events
32