Per aprire l'applicazione Contatti su un dispositivo BlackBerry e visualizzare un elenco contatti specifico, richiamare il metodo BlackBerryContactList.choose().

1. Importare le classi e le interfacce richieste.

   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. Richiamare PIM.listPIMLists(int pimListType) per restituire una matrice di oggetti String. La matrice restituita fornisce i nomi assegnati dal sistema, uno per ogni elenco PIM del tipo specificato. L'elenco predefinito del tipo specificato viene restituito all'indice 0 della matrice.

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

3. Scorrere la matrice restituita da PIM.listPIMLists() per trovare il nome assegnato dal sistema relativo all'elenco contatti che si desidera visualizzare.
4. Richiamare BlackBerryPIMList.getPIMListUID() per recuperare l'UID dell'elenco contatti.

   long uid = cl.getPIMListUID();

5. Richiamare PIM.getInstance() per recuperare un'istanza di PIM, quindi richiamare PIM.openPIMList(int, int, long) per aprire l'elenco contatti, passando come parametri il tipo di elenco da aprire (PIM.CONTACT_LIST), la modalità di accesso con cui aprire l'elenco (PIM.READ_WRITE, PIM.READ_ONLYo PIM.WRITE_ONLY) e l'UID.

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

6. Richiamare BlackBerryContactList.choose() per restituire un BlackBerryContact o un 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. Verificare la presenza di PIMException e ControlledAccessException se l'applicazione non dispone dell'autorizzazione per accedere all'applicazione che richiama.