Sie können Kontaktlisten auf einem BlackBerry-Gerät erstellen. Beachten Sie Folgendes zu selbst erstellten Kontaktlisten:

• Jede Kontaktliste hat eine eindeutige ID, bei der es sich um den von createPIMList() zurückgegebenen Wert handelt.
• Die Kontaktlisten haben keine Service-Datensätze und unterstützen keine drahtlose Synchronisierung.
• Anwendungen können durch Aufrufen von BlackBerryPIMList.addListener() registriert werden, um Änderungen an Ihrer Kontaktliste abzufragen.

1. Importieren Sie die erforderlichen Klassen und Schnittstellen.

   import javax.microedition.pim.Contact;
   import javax.microedition.pim.PIM;
   import javax.microedition.pim.PIMException;
   import javax.microedition.pim.PIMItem;
   import net.rim.blackberry.api.pdap.BlackBerryContact;
   import net.rim.blackberry.api.pdap.BlackBerryContactList;
   import net.rim.blackberry.api.pdap.BlackBerryPIM;
   import net.rim.blackberry.api.pdap.BlackBerryPIMList;

2. Rufen Sie ein BlackBerryPIM-Objekt ab.

   BlackBerryPIM myPIM = (BlackBerryPIM) PIM.getInstance();

3. Erstellen Sie die Kontaktliste.

   long listUID = myPIM.createPIMList(PIM.CONTACT_LIST, "test");

   Die Kontaktliste wird mit dem Namen benannt, den Sie angeben (im vorhergehenden Beispiel "Test"), es sei denn, es gibt eine andere Kontaktliste mit diesem Namen auf Gerät. In diesem Fall wird eine Zahl an den Namen angehängt, um ihn eindeutig zu machen. Um später auf die Kontaktliste zu verweisen, müssen Sie die UID der Liste verwenden. Hierbei handelt es sich um den von createPIMList() zurückgegebenen Wert.
4. Füllen Sie optional die Kontaktliste.

   BlackBerryContactList contactList = 
      (BlackBerryContactList) myPIM.openPIMList(PIM.CONTACT_LIST, 
       PIM.READ_WRITE, listUID);
   Contact contact = contactList.createContact();
   String[] name = new String[contactList.stringArraySize(Contact.NAME)];
   name[Contact.NAME_GIVEN] = "Noha";
   name[Contact.NAME_FAMILY] = "Toma";
   contact.addStringArray(Contact.NAME, PIMItem.ATTR_NONE, name);
   contact.commit();

5. Schließen Sie die Kontaktliste.

   contactList.close();

BlackBerryPIM myPIM = (BlackBerryPIM) PIM.getInstance();
try 
{
   // create a contact list
   long listUID = myPIM.createPIMList(PIM.CONTACT_LIST, "test");
   // add a contact to the list
   BlackBerryContactList contactList = 
      (BlackBerryContactList) myPIM.openPIMList(PIM.CONTACT_LIST, 
       PIM.READ_WRITE, listUID);
   Contact contact = contactList.createContact();
   String[] name = new String[contactList.stringArraySize(Contact.NAME)];
   name[Contact.NAME_GIVEN] = "Noha";
   name[Contact.NAME_FAMILY] = "Toma";
   contact.addStringArray(Contact.NAME, PIMItem.ATTR_NONE, name);
   contact.addString(Contact.TEL, Contact.ATTR_HOME, "519-555-0151");
   contact.addString(Contact.TEL, Contact.ATTR_WORK, "519-555-0199");
   contact.commit();
   // close the contact list
   contactList.close();
} 
catch (PIMException e) 
{
   System.out.println(e.getMessage());
}