Criar itens de menu para contatos vinculados

Você pode criar itens de menu que ficam disponíveis no aplicativo de contatos no aparelho BlackBerry quando um usuário exibe um contato vinculado a um contato em seu aplicativo invocando LinkedContactUtilities.registerMenuItems(). É preciso atribuir itens de menu a um grupo de aplicativos usando a interface LinkedContactConstants.

Grupo de aplicativos

Descrição

COMPOSE_SN_MENU_GROUP

aplicativos de rede social

COMPOSE_IM_MENU_GROUP

aplicativos de mensagens instantâneas

COMPOSE_OTHER_MENU_GROUP

aplicativos que não são aplicativos de rede social nem de mensagens instantâneas

Se um contato no aplicativo de contatos estiver vinculado a contatos em vários aplicativos de terceiros, os itens de menu no aplicativo de contatos são agrupados com outros aplicativos do mesmo grupo.

  • Itens de menu de rede social são agrupados no item de menu Rede social.
  • Itens de menu de mensagens instantâneas são agrupados no item de menu Mensagens instantâneas.
  • Os itens de menu de outros tipos de aplicativos são agrupados no item de menu Contato usando.

Os itens de menu de aplicativos de terceiros com contatos vinculados são integrados ao menu do aplicativo de contatos.

Situação

Resultado

Um grupo contém um aplicativo com contatos vinculados. O aplicativo contém um item de menu.

O item de menu do aplicativo é exibido no menu no aplicativo de contatos.

Um grupo contém um aplicativo com contatos vinculados. O aplicativo contém vários itens de menu.

O nome do aplicativo é exibido no menu. Selecionar o nome exibe uma caixa de diálogo que contém um botão para cada item de menu.

Um grupo contém vários aplicativos com contatos vinculados.

O item de menu de grupo (como Rede social) é exibido no menu. Selecionar o item de menu de grupo exibe uma caixa de diálogo com um botão para cada aplicativo com contatos vinculados no grupo.

Criar itens de menu para contatos vinculados

Você pode criar itens de menu que ficam disponíveis no aplicativo de contatos no aparelho BlackBerry quando um usuário exibir um contato vinculado a um contato em seu aplicativo.

  1. Importe as classes e interfaces necessárias.
    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. Crie uma classe que estenda a classe ApplicationMenuItem.
    public class LinkedMenuItem extends ApplicationMenuItem {...}
  3. Crie um descritor de aplicativo para seu aplicativo.
    ApplicationDescriptor appdesc = new
        ApplicationDescriptor(ApplicationDescriptor.currentApplicationDescriptor(), 
        "Linking Application", null);
    
  4. Crie uma variável para armazenar a ID exclusiva de seu aplicativo.
    public static final long APPLICATION_ID = 0x1eredfe71d34760fdL;
  5. Crie uma matriz com um ou mais instâncias do item de menu.
    ApplicationMenuItem[] items = new ApplicationMenuItem[1];
    items[0] = new LinkedMenuItem();
  6. Invoque LinkedContactUtilities.registerMenuItems() para adicionar os itens de menu do contato vinculado ao menu. Passe a matriz de itens de menu, a ID exclusiva de seu aplicativo, o grupo de aplicativos e o descritor do aplicativo.
    LinkedContactUtilities.registerMenuItems(items, APPLICATION_ID, 
        LinkedContactConstants.COMPOSE_SN_MENU_GROUP, appdesc);
    

Exemplo de código: Criar itens de menu para contatos vinculados

Para ver um exemplo de criação de itens de menu para contatos vinculados, consulte as classes SampleMenuItem e main() no aplicativo de exemplo Contact Linking Demo incluído no BlackBerry Java SDK.

Tópico anterior: Remover um vínculo

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