Creazione e registrazione di una voce di menu

Estendere la classe ApplicationMenuItem per definire una voce di menu da visualizzare nelle applicazioni di BlackBerry Device Software.

  1. Importare le classi e le interfacce richieste.
    import java.lang.IllegalStateException;
    import net.rim.blackberry.api.menuitem.ApplicationMenuItem;
    import net.rim.blackberry.api.menuitem.ApplicationMenuItemRepository;
    
  2. Per creare e registrare una voce di menu, effettuare le seguenti attività:

    Attività

    Procedura

    Definizione di una voce di menu

    1. Estendere la classe ApplicationMenuItem.
      public class SampleMenuItem extends ApplicationMenuItem { ... }

    Specifica della posizione della voce nel menu

    1. Costruire ApplicationMenuItem. Se si specifica un numero più alto nel costruttore, la voce sarà visualizzata più in basso nel menu.
      SampleMenuItem() 
      {
        super(0x350100);
      }
      

    Specifica del testo della voce di menu

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

    Specifica del comportamento della voce di menu

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

    Registrazione della voce di menu

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

Esempio di codice: creazione e registrazione di una voce di 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); 

Per ulteriori informazioni, vedere la panoramica della categoria Integrazione delle applicazioni nella documentazione di riferimento sulle API di BlackBerry Java Development Environment.

Argomento successivo: Send Menu API

Le informazioni sono state utili? Inviateci i vostri commenti.