Vous pouvez ouvrir l'application Contacts sur un terminal BlackBerry et afficher une liste de contacts spécifique en appelant la méthode BlackBerryContactList.choose().

1. Importez les classes et les interfaces requises.

   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. Appelez PIM.listPIMLists(int pimListType) pour renvoyer un tableau d'objets String. Le tableau renvoyé fournit les noms attribués par le système. Chaque liste PIM du type indiqué possède un nom. La liste par défaut du type indiqué est renvoyée à l'index 0 du tableau.

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

3. Itérez dans le tableau renvoyé par PIM.listPIMLists() pour rechercher le nom attribué par le système à la liste de contacts à afficher.
4. Appelez BlackBerryPIMList.getPIMListUID() pour récupérer l'UID de la liste de contacts.

   long uid = cl.getPIMListUID();

5. Appelez PIM.getInstance() pour récupérer une instance de PIM et appelez PIM.openPIMList(int, int, long) pour ouvrir la liste de contacts, en transmettant comme paramètres le type de liste à ouvrir (PIM.CONTACT_LIST), le mode d'ouverture de la liste (PIM.READ_WRITE, PIM.READ_ONLY ou PIM.WRITE_ONLY) et l'UID.

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

6. Appelez BlackBerryContactList.choose() pour renvoyer un objet BlackBerryContact ou 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. Recherchez toute exception PIMException et ControlledAccessException si votre application n'est pas autorisée à accéder à l'application appelée.