Sie können Informationen aus einer Kontaktliste auf einem BlackBerry-Gerät abrufen, indem Sie eine der PIMList.items()-Methoden aufrufen. Diese Methoden geben eine Aufzählung aller Kontakte in einer bestimmten Kontaktliste zurück. Sie können die BlackBerryContactList.items()-Methoden aufrufen, um Kontaktgruppen zurückgeben.

1. Importieren Sie die erforderlichen Klassen und Schnittstellen.

   import net.rim.blackberry.api.pdap.BlackBerryContact;
   import net.rim.blackberry.api.pdap.BlackBerryContactList;
   import net.rim.blackberry.api.pdap.BlackBerryPIMList;
   import java.util.Enumeration;
   import javax.microedition.pim.PIM;
   import javax.microedition.pim.PIMException;
   import javax.microedition.pim.PIMItem;

2. Rufen Sie PIM.getInstance() auf, um eine PIM-Instanz abzurufen, und rufen Sie PIM.openPIMList() auf, um eine Kontaktlisteninstanz zu öffnen, wobei Sie als Parameter die Art der zu öffnenden Liste (PIM.CONTACT_LIST), den Zugriffsmodus, mit dem die Liste geöffnet werden soll (PIM.READ_WRITE, PIM.READ_ONLY oder PIM.WRITE_ONLY), und den Namen, wenn Sie nicht die Standardkontaktliste öffnen.

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

3. Rufen Sie PIMList.items() auf, um eine Aufzählung der Elemente in einer Kontaktliste abzurufen.

   Enumeration _enum = contactList.items();

4. Rufen Sie eine der PIMItem-Abrufmethoden auf, um Kontaktinformationen abzurufen.
   • Um ein Array von Feldern abzurufen, die die Daten für einen angegebenen Kontakt enthalten, rufen Sie PIMItem.getFields() auf.
   • Rufen Sie PIMItem.getString(int field, int index) auf, um ein String abzurufen, das den Wert für ein festgelegtes Kontaktfeld darstellt.
   • Rufen Sie PIMItem.getDate(int field, int index) auf, um ein Datum abzurufen, das den Wert für ein festgelegtes Kontaktfeld darstellt.

   while (_enum.hasMoreElements())
   {
        BlackBerryContact c = (BlackBerryContact)_enum.nextElement();
        int[] fieldIds = c.getFields();
        int id;
        for(int index = 0; index < fieldIds.length; ++index)
        {
             id = fieldIds[index];
             if(c.getPIMList().getFieldDataType(id) == BlackBerryContact.STRING)
             {
                  for(int j=0; j < c.countValues(id); ++j)
                  {
                       String value = c.getString(id, j);
                       System.out.println(c.getPIMList().getFieldLabel(id) + "=" 
                         + value);
                  }
             }
        }
   }