Would you like to tell us how we are doing?

You bet No thanks

Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Buttons

Use buttons to allow users to perform an action from a dialog box. Menus typically include actions that are associated with a screen.

Users can perform the following actions with a button:

Action

BlackBerry devices with a trackpad only

BlackBerry devices with a touch screen and a trackpad

Highlight a button.

Move a finger on the trackpad.

  • Touch the button lightly.
  • Move a finger on the trackpad.

Perform an action.

Click the trackpad or press the Enter key.

  • Tap the item.
  • Click the trackpad.
  • Press the Enter key.

This screen shows an example of a button.

Best practice: Implementing buttons

Avoid using buttons on an application screen. To provide actions that are associated with a screen, use the application menu instead. On BlackBerry devices with a trackpad, the menu is available to users immediately, regardless of the position of the cursor on the screen. Buttons are static and require users to highlight a button to perform the associated action. If you use buttons, include menu items for the actions in the application menu as well. On BlackBerry devices with a touch screen, you can use buttons for critical actions.

Use check boxes for options such as turning on or turning off a feature.

Use the ButtonField class to create buttons.

For the default button, use the button that users are most likely to click. Avoid using a button that is associated with a destructive action as the default button.

Guidelines for labels

  • Use clear, concise labels.
  • Use one word labels where possible.
  • Use verbs for labels that describe the associated action (for example, "Cancel," "Delete," "Discard," or "Save").

    If necessary, include more descriptive text elsewhere on the screen (for example, in an application message).
  • Avoid using the labels Yes and No.
  • Avoid using punctuation in a label. Use an ellipsis in a button label to indicate that users must perform another action after they click the button.

Create a button

  1. Import the net.rim.device.api.ui.component.ButtonField class.

  2. Create an instance of a ButtonField using a style parameter.

    ButtonField mySubmitButton = new ButtonField("Submit");