Help Center
Local Navigation
- Creating user interfaces
- Screens
- Touch screen orientation and direction
- Working with the accelerometer of a BlackBerry device
- Types of accelerometer data
- Accelerometer
- Retrieve accelerometer data at specific intervals
- Query the accelerometer when the application is in the foreground
- Query the accelerometer when the application is in the background
- Store accelerometer readings in a buffer
- Retrieve accelerometer readings from a buffer
- Get the time a reading was taken from the accelerometer
- UI components
- Add a UI component to a screen
- Create a dialog box
- Create a bitmap
- Create a button
- Create a list
- Create a drop-down list
- Create a search field
- Create a check box
- Create an option button
- Create a date field
- Creating a text field
- Create a progress indicator
- Create a text label
- Create a list box
- Create a field to display a tree view
- Add a UI component to a screen
- Create a custom field
- Add a menu item to a BlackBerry Device Software application
- Adding a menu item to a BlackBerry Device Software application
- Register a menu item
- Arrange UI components
- Events
- Touch screen events
- Types of touch screen events
- Respond to touch screen events
- Respond to system events while the user touches the screen
- Respond to a user sliding a finger up quickly on the screen
- Respond to a user sliding a finger down quickly on the screen
- Respond to a user sliding a finger to the left quickly on the screen
- Respond to a user sliding a finger to the right quickly on the screen
- Respond to a user clicking the screen
- Respond to a user touching the screen twice quickly
- Respond to a user touching and dragging an item on the screen
- Respond to a user touching the screen lightly
- Respond to a scroll action
- Respond to a user touching the screen in two locations at the same time
- Keyboard on a BlackBerry device with a touch screen
- Spell check
- Accessibility
- Integrating with assistive technology software
- Notifying an assistive technology application when the UI changes
- UI changes that trigger a notification to an assistive technology application
- UI component states and properties
- Provide an assistive technology application with information about a UI change
- Provide an assistive technology application with information about text changes
- Provide an assistive technology application with access to information from a table
- Provide an assistive technology application with access to numeric values
- Enable an assistive technology application to receive notification of UI events
- Storing data
- Creating connections
- Managing applications
- Using custom messages and folders in the message list
- Applications for push content
- Localizing BlackBerry device applications
- Controlling access to APIs and application data
- Testing a BlackBerry device application
- Packaging and distributing a BlackBerry Java Application
- Glossary
- Provide feedback
- Legal notice
BlackBerry Manuals & Help
>
Documentation for Developers
>
Java Development Guides and API Reference
>
Development Guide - BlackBerry Java Development Environment - 4.7.0
Add a menu item to a BlackBerry Device Software application
- Import the required classes and interfaces.
import net.rim.blackberry.api.menuitem.*; import net.rim.blackberry.api.pdap.*; import net.rim.device.api.ui.*; import net.rim.device.api.ui.component.*;
- Extend the abstract ApplicationMenuItem class, to create a menu item.
Override the ApplicationMenuItem()
constructor with an integer to specify the position of the menu item in the menu. A higher number positions the menu item lower in the menu.
public class SampleMenuItem extends ApplicationMenuItem { SampleMenuItem() { super(20); } } - Implement the toString() method,
to specify text that the menu item displays.
public String toString() { return "Open the Contacts Demo application"; } - Invoke getInstance(), to retrieve the application repository.
ApplicationMenuItemRepository repository = ApplicationMenuItemRepository.getInstance();
- Create an instance of class to extend the MenuItem class.
ContactsDemoMenuItem contactsDemoMenuItem = new ContactsDemoMenuItem();
- Invoke ApplicationMenuItemRepository.addMenuItem(), to add the menu item to the relevant BlackBerry device application repository.
repository.addMenuItem(ApplicationMenuItemRepository.MENUITEM_ADDRESSCARD_VIEW, contactsDemoMenuItem);
- Implement the run()
method to specify the behavior of the menu item.
In the following code sample, when a user clicks the new menu item and a Contact exists, the ContactsDemo application receives the events and invokes ContactsDemo.enterEventDispatcher().
public Object run(Object context) { BlackBerryContact c = (BlackBerryContact)context; if ( c != null ) { new ContactsDemo().enterEventDispatcher(); } else { throw new IllegalStateException( "Context is null, expected a Contact instance"); } Dialog.alert("Viewing an email message in the email view"); return null; }
Parent topic: UI components