
36
BlackBerry Java Development Environment Development Guide
Adding menu items to BlackBerry applications
The Application Menu Item API, in the net.rim.blackberry.api.menuitem package, lets you add menu items
to BlackBerry® applications. The
ApplicationMenuItemRepository class lets you add or remove menu items
from BlackBerry applications.
Create a menu item
Register a menu item
Task Steps
Define a menu item. > Extend the abstract ApplicationMenuItem class.
public class SampleMenuItem extends ApplicationMenuItem { ... }
Specify the position of the menu
item in the menu.
A higher number means that the menu item appears lower in the menu.
>Invoke ApplicationMenuItem().
SampleMenuItem() {
super(20);
}
Specify the menu item text. > Implement toString().
public String toString() {
return "Open the Contacts Demo application";
}
Specify the behavior of the menu
item.
> Implement run().
public Object run(Object context) {
Contact c = (Contact)context; // An error occurs if this does not work.
if ( c ! null ) {
new ContactsDemo().enterEventDispatcher();
} else {
throw new IllegalStateException( "Context is null, expected a Contact
instance");
}
Dialog.alert("Viewing a message in the messaging view");
return null;
}
Task Steps
Retrieve the application menu item
repository.
>Invoke ApplicationMenuItemRepository.getInstance().
ApplicationMenuItemRepository repository =
ApplicationMenuItemRepository.getInstance();
Create your application menu item. > Invoke the constructor.
TestApplicationMenuItem tami = new TestApplicationMenuItem();
Add the menu item to the repository. >Invoke addMenuItem().
repository.addMenuItem(ApplicationMenuItemRepository.MENUITEM_ADDRESSC
ARD_VIEW, tami);
Komentáře k této Příručce