Créer une liste de contacts

Vous pouvez créer des listes de contacts sur un terminal BlackBerry. Notez les points suivants à propos des listes de contacts que vous créez :

  • Chaque liste de contacts dispose d'un ID unique, qui est la valeur renvoyée par createPIMList().
  • Les listes de contacts n'ont pas d'enregistrements de service et ne prennent pas en charge la synchronisation sans fil.
  • Les applications peuvent s'enregistrer pour écouter les modifications apportées à votre liste de contacts en appelant BlackBerryPIMList.addListener().
  1. Importez les classes et les interfaces requises.
    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. Récupérez un objet BlackBerryPIM.
    BlackBerryPIM myPIM = (BlackBerryPIM) PIM.getInstance();
  3. Créez la liste de contacts.
    long listUID = myPIM.createPIMList(PIM.CONTACT_LIST, "test");
    La liste de contacts est nommée d'après le nom que vous indiquez (« test » dans l'exemple précédent), à moins qu'il n'existe déjà une autre liste de contacts portant ce nom sur le terminal, auquel cas un numéro est ajouté au nom pour le rendre unique. Par la suite, pour référencer la liste de contacts, utilisez son UID, qui est la valeur renvoyée par createPIMList().
  4. Remplissez éventuellement la liste de contacts.
    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. Fermez la liste de contacts.
    contactList.close();

Échantillon de code

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());
}

Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.