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.