Abrir o aplicativo de contatos com uma lista de contatos específica

Você pode abrir o aplicativo de contatos em um aparelho BlackBerry e exibir uma lista de contatos específica invocando o método BlackBerryContactList.choose().

  1. Importe as classes e interfaces necessárias.
    import net.rim.blackberry.api.pdap.BlackBerryContact;
    import net.rim.blackberry.api.pdap.BlackBerryContactGroup;
    import net.rim.blackberry.api.pdap.BlackBerryContactList;
    import net.rim.blackberry.api.pdap.BlackBerryPIM;
    import net.rim.blackberry.api.pdap.BlackBerryPIMList;
    import net.rim.device.api.system.ControlledAccessException;
    import javax.microedition.pim.PIM;
    import javax.microedition.pim.PIMException;
    import javax.microedition.pim.PIMItem;
  2. Invoque PIM.listPIMLists(int pimListType)para retornar uma matriz de objetos String. A matriz retornada fornece os nomes atribuídos pelo sistema, um para cada lista de PIM do tipo especificado. A lista padrão do tipo especificado é retornada no índice 0 da matriz.
    String[] lists = PIM.listPIMLists(PIM.CONTACT_LIST);
  3. Faça a iteração pela matriz retornada por PIM.listPIMLists() para pesquisar o nome atribuído pelo sistema à lista de contatos que você deseja exibir.
  4. Invoque BlackBerryPIMList.getPIMListUID() para retornar a UID da lista de contatos.
    long uid = cl.getPIMListUID();
  5. Invoque PIM.getInstance() para recuperar uma PIM instância e execute PIM.openPIMList(int, int, long) para abrir a lista de contatos, passando a lista a ser aberta como parâmetro (PIM.CONTACT_LIST), o modo de acesso pelo qual a lista é aberta (PIM.READ_WRITE, PIM.READ_ONLY ou PIM.WRITE_ONLY) e a UID.
    BlackBerryContactList list = (BlackBerryContactList) 
        PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, uid);
    
  6. Invoque BlackBerryContactList.choose() para retornar um BlackBerryContact ou um BlackBerryContactGroup PIMItem.
    PIMItem item = list.choose(); 
    if (item instanceof BlackBerryContact)
    {
         BlackBerryContact contact = (BlackBerryContact) item;
         int values = contact.countValues(BlackBerryContact.EMAIL);
         String email = contact.getString(BlackBerryContact.EMAIL, 0);
         System.out.println("Email is: " + email);
    }
    else if (item instanceof BlackBerryContactGroup)
    {
    ...
    }
  7. Verifique se há PIMException e ControlledAccessException se seu aplicativo não tiver permissão para acessar o aplicativo que ele executa.

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