Crear elementos del menú para contactos vinculados

Puede crear elementos del menú que estén disponibles en la aplicación Contactos en el dispositivo BlackBerry cuando un usuario vea un contacto que está vinculado con un contacto en su aplicación invocando LinkedContactUtilities.registerMenuItems(). Debe asignar elementos del menú a un grupo de aplicaciones utilizando la interfaz LinkedContactConstants.

Grupo de aplicaciones

Descripción

COMPOSE_SN_MENU_GROUP

aplicaciones de redes sociales

COMPOSE_IM_MENU_GROUP

aplicaciones de mensajería instantánea

COMPOSE_OTHER_MENU_GROUP

aplicaciones que no son aplicaciones de redes sociales ni aplicaciones de mensajería instantánea

Si un contacto de la aplicación Contactos está vinculado con contactos de varias aplicaciones de terceros, los elementos del menú de la aplicación de contactos se agrupan con otras aplicaciones del mismo grupo.

  • Los elementos del menú de redes sociales se agrupan dentro del elemento del menú Redes sociales.
  • Los elementos del menú de mensajería instantánea se agrupan dentro el elemento del menú Mensajería instantánea.
  • Los elementos del menú de otros tipos de aplicaciones se agrupan dentro del elemento del menú Contactar mediante.

Los elementos del menú de aplicaciones de terceros con contactos vinculados se integran con el menú de la aplicación Contactos.

Situación

Resultado

Un grupo contiene una aplicación con contactos vinculados. La aplicación contiene un elemento del menú.

El elemento del menú de la aplicación aparece en el menú de la aplicación Contactos.

Un grupo contiene una aplicación con contactos vinculados. La aplicación contiene varios elementos del menú.

El nombre de la aplicación aparece en el menú. Al seleccionar el nombre aparece un cuadro de diálogo que contiene un botón para cada elemento del menú.

Un grupo contiene varias aplicaciones con contactos vinculados.

El elemento del menú del grupo (como Redes sociales) aparece en el menú. Al seleccionar el elemento del menú del grupo, se muestra un cuadro de diálogo con un botón para cada aplicación con contactos vinculados en el grupo.

Crear elementos del menú para contactos vinculados

Puede crear elementos del menú disponibles en la aplicación Contactos del dispositivo BlackBerry cuando un usuario vea un contacto que vinculado con un contacto de su aplicación.

  1. Importe las clases y las interfaces necesarias.
    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. Cree una clase que amplíe la clase ApplicationMenuItem.
    public class LinkedMenuItem extends ApplicationMenuItem {...}
  3. Cree un descriptor de aplicación para su aplicación.
    ApplicationDescriptor appdesc = new
        ApplicationDescriptor(ApplicationDescriptor.currentApplicationDescriptor(), 
        "Linking Application", null);
    
  4. Cree una variable para almacenar el ID único de su aplicación.
    public static final long APPLICATION_ID = 0x1eredfe71d34760fdL;
  5. Cree una matriz con una o más instancias del elemento del menú.
    ApplicationMenuItem[] items = new ApplicationMenuItem[1];
    items[0] = new LinkedMenuItem();
  6. Invoque LinkedContactUtilities.registerMenuItems() para agregar los elementos del menú para el contacto vinculado al menú. Pase la matriz de elementos del menú, el ID único de su aplicación, el grupo de aplicaciones y el descriptor de la aplicación.
    LinkedContactUtilities.registerMenuItems(items, APPLICATION_ID, 
        LinkedContactConstants.COMPOSE_SN_MENU_GROUP, appdesc);
    

Ejemplo de código: Crear elementos del menú para contactos vinculados

Para consultar un ejemplo de creación de elementos de menú para contactos vinculados, consulte la clase SampleMenuItem y main() en la aplicación de ejemplo de demostración de vinculación de contactos que se incluye en BlackBerry Java SDK.

Tema anterior: Eliminar un vínculo

¿Le ha resultado útil esta información? Envíenos sus comentarios.