Sie können die Kontaktanwendung auf einem BlackBerry-Gerät öffnen und eine bestimmte Kontaktliste anzeigen, indem Sie die BlackBerryContactList.choose()-Methode aufrufen.

1. Importieren Sie die erforderlichen Klassen und Schnittstellen.

   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. Rufen Sie PIM.listPIMLists(int pimListType) auf, um ein Array von String-Objekten zurückzugeben. Das zurückgegebene Array stellt die vom System zugewiesenen Namen bereit, und zwar einen für jede PIM-Liste des angegebenen Typs. Die Standardliste des angegebenen Typs wird bei Index 0 des Arrays zurückgegeben.

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

3. Führen Sie eine Iteration durch das Array durch, das von PIM.listPIMLists() zurückgegeben wird, um nach dem vom System zugewiesenen Namen für die Kontaktliste zu suchen, die Sie anzeigen möchten.
4. Rufen Sie BlackBerryPIMList.getPIMListUID() auf, um die UID für die Kontaktliste zurückzugeben.

   long uid = cl.getPIMListUID();

5. Rufen Sie PIM.getInstance() auf, um eine PIM-Instanz abzurufen, und rufen Sie PIM.openPIMList(int, int, long) auf, um die Kontaktliste zu öffnen, wobei Sie als Parameter die Art der zu öffnenden Liste (PIM.CONTACT_LIST) sowie den Zugriffsmodus, mit dem die Liste geöffnet werden soll (PIM.READ_WRITE, PIM.READ_ONLY oder PIM.WRITE_ONLY) und die UID übergeben.

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

6. Rufen Sie BlackBerryContactList.choose() auf, um ein BlackBerryContact oder ein BlackBerryContactGroup PIMItem zurückzugeben.

   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. Prüfen Sie auf PIMException und auf ControlledAccessException, wenn Ihre Anwendung nicht die Berechtigung besitzt, auf die Anwendung zuzugreifen, die sie aufruft.