Création d'éléments de menu pour des contacts liés

Vous pouvez créer des éléments de menu disponibles dans l'application Contacts du terminal BlackBerry lorsque l'utilisateur affiche un contact lié à un contact de votre application en appelant LinkedContactUtilities.registerMenuItems(). Attribuez des éléments de menu à un groupe d'applications à l'aide de l'interface LinkedContactConstants.

Groupe d'applications

Description

COMPOSE_SN_MENU_GROUP

Applications de mise en réseau social

COMPOSE_IM_MENU_GROUP

Applications de messagerie instantanée

COMPOSE_OTHER_MENU_GROUP

Applications n'étant ni de type application de mise en réseau social ni application de messagerie instantanée

Si un contact de l'application Contacts est lié à des contacts dans plusieurs applications tierces, les éléments de menu de l'application Contacts sont regroupées avec les autres applications du même groupe.

  • Les éléments de menu de mise en réseau social sont regroupés sous l'élément de menu Réseau social.
  • Les éléments de menu de messagerie instantanée sont regroupés sous l'élément de menu Messagerie instantanée.
  • Les éléments de menu d'applications d'autre type sont regroupés sous l'élément de menu Contact au moyen de.

Les éléments de menu des applications tierces avec contacts liés sont intégrés au menu de l'application Contacts.

Situation

Résultat

Un groupe intègre une application avec contacts liés. L'application intègre un élément de menu.

L'élément de menu de l'application s'affiche dans le menu de l'application Contacts.

Un groupe intègre une application avec contacts liés. L'application intègre plusieurs éléments de menu.

Le nom de l'application s'affiche dans le menu. La sélection du nom affiche une boîte de dialogue intégrant un bouton pour chaque élément de menu.

Un groupe intègre plusieurs applications avec contacts liés.

L'élément de menu de groupe (tel que Réseau social) s'affiche dans le menu. La sélection de l'élément de menu de groupe affiche une boîte de dialogue contenant un bouton pour chaque application avec contacts liés dans le groupe.

Créer des éléments de menu pour des contacts liés

Vous pouvez créer des éléments de menu disponibles dans l'application Contacts du terminal BlackBerry lorsqu'un utilisateur affiche un contact lié à un contact de votre application.

  1. Importez les classes et les interfaces requises.
    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. Créez une classe développant la classe ApplicationMenuItem.
    public class LinkedMenuItem extends ApplicationMenuItem {...}
  3. Créez un descripteur d'application pour votre application.
    ApplicationDescriptor appdesc = new
        ApplicationDescriptor(ApplicationDescriptor.currentApplicationDescriptor(), 
        "Linking Application", null);
    
  4. Créez une variable de stockage de l'ID unique de votre application.
    public static final long APPLICATION_ID = 0x1eredfe71d34760fdL;
  5. Créez un tableau avec une ou plusieurs instances d'éléments de menu.
    ApplicationMenuItem[] items = new ApplicationMenuItem[1];
    items[0] = new LinkedMenuItem();
  6. Appelez LinkedContactUtilities.registerMenuItems() pour ajouter les éléments de menu du contact lié au menu. Transmettez le tableau d'éléments de menu, l'ID unique de votre application, le groupe d'applications et le descripteur d'application.
    LinkedContactUtilities.registerMenuItems(items, APPLICATION_ID, 
        LinkedContactConstants.COMPOSE_SN_MENU_GROUP, appdesc);
    

Échantillon de code : création d'éléments de menu pour des contacts liés

Pour consulter un exemple de création d'éléments de menu, reportez-vous à la classe SampleMenuItem et à main()dans l'exemple d'application Contact Linking Demo inclus dans BlackBerry Java SDK.

Sujet précédent: Supprimer une association

Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.