Help Center

Local Navigation

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.

Index


Was this information helpful? Send us your comments.