Touch screen

On BlackBerry® devices with a touch screen, users can navigate and type text using the touch screen.

In most cases, an action occurs when users lift their finger off the touch screen, not when they touch the screen. However, when users touch an item or touch and hold a finger on an item, the action occurs before users lift their finger.

Users can perform the following actions on a touch screen:

User action

Event

Result

Tap the screen.

TouchGesture.TAP

This action initiates an action. For example, when users tap an email message in the message list, the message opens. In most cases, this action is equivalent to clicking the trackpad.

Tap the screen twice quickly in the same location.

TouchGesture.DOUBLE_TAP

This action fits the content in a picture, HTML email message, web page, or attachment into the dimensions of the screen.

Touch an item.

TouchEvent.DOWN

TouchEvent.UP

This action highlights an item.

On a toolbar or the virtual keyboard, this action displays a tooltip.

Touch and hold a finger on an item.

TouchGesture.HOVER

If a pop-up menu is available, this action opens the pop-up menu.

Drag a finger vertically.

TouchEvent.MOVE

This action scrolls and moves the content on the screen. For example, on the Home screen, users can move the rows of applications up or down to display the preferred number of applications on the screen.

Drag a finger in any direction.

TouchEvent.MOVE

This action pans a picture, map, or web page.

Touch the screen in two locations at the same time.

TouchEvent.DOWN

TouchEvent.DOWN

This action highlights text or a list of items, such as messages, between the two locations.

Swipe across the screen.

TouchGesture.SWIPE

This action moves the content on the screen quickly in the direction of the swipe.

Pinch open or pinch close.

TouchGesture.PINCH_BEGIN

TouchGesture.PINCH_UPDATE

TouchGesture.PINCH_END

These actions zoom in to and out from an item.

Best practice: Implementing touch screen actions

  • Respond to each touch action that you use in your application. For more information about how to respond to events created by each action, see the BlackBerry UI and Navigation Development Guide.
  • Where possible, create a target area for user interface elements that is at least 6 mm.
  • Provide enough space around components so that users can easily touch the screen with their fingertips to initiate a specific action.
  • If you want your application to work on BlackBerry® devices with a trackpad only, make sure that each touch screen event has an associated trackpad function. Test your application on BlackBerry devices with a trackpad and without a trackpad. The following information matches touch screen actions and trackpad actions:

Desired result

Touch screen action

Trackpad action

Initiate an action.

Tap the screen.

Click the trackpad.

Scroll.

Drag a finger vertically on the screen.

Move a finger on the trackpad to move the highlight.

Move to the next or previous item.

Swipe across the screen.

Swipe across the trackpad in the opposite direction.

Zoom.

Pinch open.

Click the trackpad.

Zoom to fit.

Tap the screen twice quickly.

Press the Menu key. Click Fit to Screen.

Pan a zoomed image.

Drag a finger on the screen.

Move a finger on the trackpad in the opposite direction.

Display a pop-up menu.

Touch and hold a finger on the screen.

Click and hold the trackpad.

Next topic: Keyboard

Was this information helpful? Send us your comments.