Puede crear un contacto y asignarlo a la lista de contactos predeterminada o bien a otra lista de contactos de un dispositivo BlackBerry.

1. Importe las clases y las interfaces necesarias.

   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 agregar el contacto nuevo a la lista de contactos predeterminada, invoque PIM.openPIMList(int, int) para abrir una instancia de la lista de contactos predeterminada, pasando como parámetros el tipo de lista que se va a abrir (PIM.CONTACT_LIST) y el modo de acceso PIM.READ_WRITE. Avance hasta el paso 4.

   BlackBerryContactList contactList = (BlackBerryContactList) 
       PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);

3. Para agregar el contacto nuevo a una lista de contactos que no sea la lista de contactos predeterminada, realice las acciones siguientes:
   1. Invoque PIM.listPIMLists(int), pasando como parámetro el tipo de lista (PIM.CONTACT_LIST), para devolver una matriz de objetos String. La matriz devuelta ofrece los nombres asignados por el sistema a cada lista de contactos. La lista de contactos predeterminada se devuelve en el índice 0 de la matriz.

      String[] lists = PIM.listPIMLists(PIM.CONTACT_LIST);

   2. Itere sobre la matriz que devuelve PIM.listPIMLists() para buscar el nombre asignado por el sistema a la lista de contactos que desea abrir.
   3. Invoque PIM.openPIMList(int, int, String) para abrir la instancia de la lista de contactos, pasando como parámetro el tipo de lista que se va a abrir (PIM.CONTACT_LIST), el modo de acceso PIM.READ_WRITE y el nombre de la lista de contactos.

      BlackBerryContactList contactList = (BlackBerryContactList) 
          PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, name);

4. Invoque ContactList.createContact() para agregar el contacto nuevo a la lista de contactos.

   BlackBerryContact contact = contactList.createContact();

5. Invoque uno o más de los métodos siguientes para agregar información referente al contacto nuevo. Para obtener más información acerca de métodos PIMItem, consulte la referencia de API para BlackBerry Java Development Environment.
   • addString()
   • addStringArray()
   • addDate()
   • addInt()
   • addBoolean()
   • addBinary()
6. Invoque los métodos siguientes para comprobar que la información cumple los requisitos de tamaño y de tipo del campo especificado del contacto.
   • Invoque ContactList.isSupportedField(int) para comprobar que el elemento es compatible con el tipo de campo.
   • Invoque ContactList.isSupportedAttribute(int, int) para comprobar que el campo es compatible con el atributo especificado.
   • Invoque PIMList.maxValues(int field) para comprobar el número de valores con los que es compatible el campo.
7. Invoque Contact.commit() para acometer los cambios.

   if(contact.isModified())
   {
       contact.commit();
   }

8. Busque PIMException y ControlledAccessException si su aplicación no tiene permiso para acceder a la aplicación que invoca.