Criar e registrar um item de menu

Estenda a classe ApplicationMenuItem para definir um item de menu a ser exibido em aplicativos do BlackBerry Device Software.

  1. Importe as classes e interfaces necessárias.
    import java.lang.IllegalStateException;
    import net.rim.blackberry.api.menuitem.ApplicationMenuItem;
    import net.rim.blackberry.api.menuitem.ApplicationMenuItemRepository;
    
  2. Para criar e registrar um item de menu, execute as seguintes tarefas:

    Tarefa

    Etapas

    Definir um item de menu

    1. Estenda a classe ApplicationMenuItem.
      public class SampleMenuItem extends ApplicationMenuItem { ... }

    Especificar a posição do item no menu

    1. Construa o ApplicationMenuItem. Um número mais alto no construtor significa que o item de menu é exibido mais abaixo no menu.
      SampleMenuItem() 
      {
        super(0x350100);
      }
      

    Especificar o texto do item de menu

    1. Implemente toString().
      public String toString() 
      {
        return "My menu item";
      }
      

    Especificar o comportamento do item de menu

    1. Implemente run().
      public Object run(Object context) 
      {
        // the menu's action here
        return null;
      }
      

    Registrar o item de menu

    1. Invoque ApplicationMenuItemRepository.addMenuItem().
      ApplicationMenuItemRepository amir = 
        ApplicationMenuItemRepository.getInstance();
      amir.addMenuItem(
        ApplicationMenuItemRepository.MENUITEM_PHONE, 
        mySampleMenuItem);
      

Exemplo de código: Criar e registrar um item de menu

// Create menu item 
int placement = 0x350100; 
ApplicationMenuItem ami = new ApplicationMenuItem(placement) 
{ 
   public Object run(Object context) 
   { 
      // do something 
      return null; 
   } 
   public String toString()
   { 
      return "My menu item"; 
   } 
}; 
// Register menu item to display when user views a contact
ApplicationMenuItemRepository amir = ApplicationMenuItemRepository.getInstance();
amir.addMenuItem(ApplicationMenuItemRepository.MENUITEM_ADDRESSCARD_VIEW, ami); 

Para obter mais informações, consulte a visão geral da integração de aplicativos na referência da API do BlackBerry Java Development Environment.

Próximo tópico: Send Menu API

Estas informações foram úteis? Gostaríamos de receber seus comentários.