Types of touch screen events
A TouchEvent class represents a touch input action that a BlackBerry® device user performs.
A TouchGesture class represents an event that is a combination of touch input actions that a BlackBerry device user performs.
In the following table, all the events are in the net.rim.device.api.ui package.
Action |
Event | Result |
|---|---|---|
touch the screen lightly |
TouchEvent.DOWN |
This action highlights an item. In a text field, if users touch the screen near the cursor, an outlined box displays around the cursor. This box helps users reposition the cursor more easily. |
tap the screen |
TouchGesture.TAP |
In applications that support a full-screen view, such as BlackBerry® Maps and the BlackBerry® Browser, this action hides and shows the shortcut bar. |
tap the screen twice |
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 |
TouchEvent.CLICK |
This action initiates 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 trackwheel, trackball or trackpad. 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. In a text field, this action positions the cursor. If the field contains text, an outlined box appears around the cursor. |
slide a finger up or down quickly on the screen |
TouchGesture.SWIPE_NORTH TouchGesture.SWIPE_SOUTH |
Sliding a finger up quickly scrolls or displays the next screen. Sliding a finger down quickly scrolls or 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 |
TouchGesture.SWIPE_WEST TouchGesture.SWIPE_EAST |
This action scrolls, or 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 |
TouchGesture.HOVER |
On the shortcut bar, this action displays a tooltip that describes the action that the icon represents. In a message list, if users hold a finger on the sender or subject of a message, the BlackBerry device searches for the sender or subject. |
touch and drag an item on the screen |
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. In a text field, this action moves the outlined box and the cursor in the same direction. |
touch the screen in two locations at the same time |
TouchEvent.DOWN TouchEvent.MOVE |
This action highlights the text or the list of items, such as messages, between the two locations. To add or remove text or items from the selection, users can touch the screen at another location. |
touch the screen in two locations at the same time and drag both fingers |
TouchEvent.DOWN TouchEvent.MOVE |
This action moves two items on the screen in the corresponding directions. |