Criar um contato e atribuí-lo a uma lista de contatos

Você pode criar um contato e atribuí-lo à lista de contatos padrão ou a outra lista de contatos em um aparelho BlackBerry.

  1. Importe as classes e interfaces necessárias.
    import net.rim.blackberry.api.pdap.BlackBerryContact; 
    import net.rim.blackberry.api.pdap.BlackBerryContactList;
    import net.rim.blackberry.api.pdap.BlackBerryPIMList;
    import net.rim.device.api.system.ControlledAccessException;
    import javax.microedition.pim.PIM;
    import javax.microedition.pim.PIMList;
    import javax.microedition.pim.PIMException;
    import javax.microedition.pim.ContactList;
  2. Para adicionar o novo contato à lista de contatos padrão, execute PIM.openPIMList(int, int) para abrir a instância padrão da lista de contatos, passando o tipo de lista a ser aberta (PIM.CONTACT_LIST) e o modo de acesso PIM.READ_WRITE como parâmetros. Prossiga à etapa 4.
    BlackBerryContactList contactList = (BlackBerryContactList) 
        PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);
  3. Para adicionar o novo contato a uma lista de contatos que não seja a lista de contatos padrão, execute as seguintes ações:
    1. Invoque PIM.listPIMLists(int) passando o tipo de lista como parâmetro (PIM.CONTACT_LIST) para retornar uma matriz de objetos String. A matriz retornada fornece os nomes atribuídos pelo sistema a cada lista de contatos. A lista de contatos padrão é retornada no índice 0 da matriz.
      String[] lists = PIM.listPIMLists(PIM.CONTACT_LIST);
    2. Faça a iteração pela matriz PIM.listPIMLists() retornada para pesquisar o nome atribuído pelo sistema à lista de contatos que você deseja abrir.
    3. Invoque PIM.openPIMList(int, int, String) para abrir a instância da lista de contatos, passando o tipo de lista a ser aberta como parâmetro (PIM.CONTACT_LIST), o modo de acesso PIM.READ_WRITE e o nome da lista de contato.
      BlackBerryContactList contactList = (BlackBerryContactList) 
          PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, name);
  4. Invoque ContactList.createContact() para adicionar o novo contato à lista de contatos.
    BlackBerryContact contact = contactList.createContact();
  5. Invoque um ou mais dos seguintes métodos para adicionar informações ao novo contato. Para obter mais informações sobre métodos PIMItem, consulta a referência de API para o BlackBerry Java Development Environment.
    • addString()
    • addStringArray()
    • addDate()
    • addInt()
    • addBoolean()
    • addBinary()
  6. Invoque os seguintes métodos para verificar se as informações atendem aos requisitos de tamanho e digite os requisitos do campo de contato especificado.
    • Invoque ContactList.isSupportedField(int) para verificar se o item oferece suporte ao tipo de campo.
    • Invoque ContactList.isSupportedAttribute(int, int) para verificar se o campo oferece suporte ao atributo especificado.
    • Invoque PIMList.maxValues(int field) para verificar o número de valores aos quais o campo oferece suporte.
  7. Invoque Contact.commit() para confirmar as alterações.
    if(contact.isModified())
    {
        contact.commit();
    }
  8. Verifique se há PIMException e ControlledAccessException se seu aplicativo não tiver permissão para acessar o aplicativo que ele invoca.

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