Creazione di voci di menu per i contatti collegati

È possibile creare voci di menu disponibili nell'applicazione Contatti del dispositivo BlackBerry quando un utente visualizza un contatto collegato a un altro contatto nell'applicazione, richiamando LinkedContactUtilities.registerMenuItems(). È necessario assegnare le voci di menu a un gruppo di applicazioni utilizzando l'interfaccia LinkedContactConstants.

Gruppo di applicazioni

Descrizione

COMPOSE_SN_MENU_GROUP

Applicazioni di social networking

COMPOSE_IM_MENU_GROUP

Applicazioni di messaggistica istantanea

COMPOSE_OTHER_MENU_GROUP

Applicazioni diverse da quelle per social networking o messaggistica istantanea

Se un contatto nell'applicazione Contatti è collegato a contatti in più applicazioni di terzi, le voci di menu nell'applicazione Contatti vengono raggruppate con altre applicazioni dello stesso gruppo.

  • Le voci di menu di social networking sono raggruppate nella voce di menu Social networking.
  • Le voci di menu di messaggistica istantanea sono raggruppate nella voce di menu Messaggistica istantanea.
  • Le voci di menu degli altri tipi di applicazione sono raggruppate nella voce di menu Contatta con.

Le voci di menu delle applicazioni di terzi con contatti collegati vengono integrate nel menu per l'applicazione Contatti.

Situazione

Risultato

Un gruppo contiene un'applicazione con contatti collegati. L'applicazione contiene una voce di menu.

La voce di menu relativa all'applicazione viene visualizzata nel menu dell'applicazione Contatti.

Un gruppo contiene un'applicazione con contatti collegati. L'applicazione contiene più voci di menu.

Il nome dell'applicazione compare nel menu. Se si seleziona il nome, compare una finestra di dialogo che contiene un pulsante per ogni voce di menu.

Un gruppo contiene più applicazioni con contatti collegati.

La voce di menu del gruppo (ad esempio Social networking) compare nel menu. Se si seleziona la voce di menu del gruppo, compare una finestra di dialogo con un pulsante per ogni applicazione con contatti collegati nel gruppo.

Creazione di voci di menu per i contatti collegati

Quando un utente visualizza un contatto collegato a un altro contatto nell'applicazione, è possibile creare voci di menu disponibili nell'applicazione Contatti del dispositivo BlackBerry.

  1. Importare le classi e le interfacce richieste.
    import net.rim.blackberry.api.menuitem.ApplicationMenuItem;
    import net.rim.blackberry.api.pdap.contactlinking.LinkedContactConstants;
    import net.rim.blackberry.api.pdap.contactlinking.LinkedContactUtilities;
    import net.rim.device.api.system.ApplicationDescriptor;
  2. Creare una classe che estenda la classe ApplicationMenuItem.
    public class LinkedMenuItem extends ApplicationMenuItem {...}
  3. Creare un descrittore per l'applicazione.
    ApplicationDescriptor appdesc = new
        ApplicationDescriptor(ApplicationDescriptor.currentApplicationDescriptor(), 
        "Linking Application", null);
    
  4. Creare una variabile per archiviare l'ID univoco dell'applicazione.
    public static final long APPLICATION_ID = 0x1eredfe71d34760fdL;
  5. Creare una matrice con una o più istanze di voci di menu.
    ApplicationMenuItem[] items = new ApplicationMenuItem[1];
    items[0] = new LinkedMenuItem();
  6. Richiamare LinkedContactUtilities.registerMenuItems() per aggiungere le voci di menu per il contatto collegato. Passare la matrice di voci di menu, l'ID univoco dell'applicazione, il gruppo di applicazioni e il descrittore dell'applicazione.
    LinkedContactUtilities.registerMenuItems(items, APPLICATION_ID, 
        LinkedContactConstants.COMPOSE_SN_MENU_GROUP, appdesc);
    

Esempio di codice: creazione di voci di menu per i contatti collegati

Per un esempio di creazione di voci di menu per i contatti collegati, vedere la classe SampleMenuItem e main() nell'applicazione di prova della demo di collegamento dei contatti, inclusa in BlackBerry Java SDK.

Argomento precedente: Rimozione di un collegamento

Le informazioni sono state utili? Inviateci i vostri commenti.