Créer un contact et l'affecter à une liste de contacts

Vous pouvez créer un contact et l'affecter à la liste de contacts par défaut ou à une autre liste de contacts sur un terminal BlackBerry.

  1. Importez les classes et les interfaces requises.
    import net.rim.blackberry.api.pdap.BlackBerryContact; 
    import net.rim.blackberry.api.pdap.BlackBerryContactList;
    import net.rim.blackberry.api.pdap.BlackBerryPIMList;
    import net.rim.device.api.system.ControlledAccessException;
    import javax.microedition.pim.PIM;
    import javax.microedition.pim.PIMList;
    import javax.microedition.pim.PIMException;
    import javax.microedition.pim.ContactList;
  2. Pour ajouter le nouveau contact à la liste de contacts par défaut, appelez PIM.openPIMList(int, int) pour ouvrir l'instance de la liste de contacts par défaut, en transmettant comme paramètres le type de liste à ouvrir (PIM.CONTACT_LIST) et le mode d'accès PIM.READ_WRITE. Passez à l'étape 4.
    BlackBerryContactList contactList = (BlackBerryContactList) 
        PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);
  3. Pour ajouter le nouveau contact à une liste de contacts qui n'est pas la liste de contacts par défaut, procédez comme suit :
    1. Appelez PIM.listPIMLists(int) en transmettant comme paramètre le type de liste à ouvrir (PIM.CONTACT_LIST), pour renvoyer un tableau d'objets String. Le tableau renvoyé fournit les noms attribués par le système pour chaque liste de contacts. La liste de contacts par défaut est renvoyée à l'index 0 du tableau.
      String[] lists = PIM.listPIMLists(PIM.CONTACT_LIST);
    2. Itérez dans le tableau renvoyé par PIM.listPIMLists() pour rechercher le nom attribué par le système à la liste de contacts que vous souhaitez ouvrir.
    3. Appelez PIM.openPIMList(int, int, String) pour ouvrir l'instance de la liste de contacts, en transmettant comme paramètres le type de liste à ouvrir (PIM.CONTACT_LIST), le mode d'accès PIM.READ_WRITE et le nom de la liste de contacts.
      BlackBerryContactList contactList = (BlackBerryContactList) 
          PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, name);
  4. Appelez ContactList.createContact() pour ajouter le nouveau contact à la liste de contacts.
    BlackBerryContact contact = contactList.createContact();
  5. Appelez des méthodes parmi les suivantes afin d'ajouter des informations au nouveau contact. Pour plus d'informations à propos des méthodes PIMItem, consultez la référence API de BlackBerry Java Development Environment.
    • addString()
    • addStringArray()
    • addDate()
    • addInt()
    • addBoolean()
    • addBinary()
  6. Appelez les méthodes suivantes pour vérifier que les informations répondent aux exigences de taille et de type du champ de contact indiqué.
    • Appelez ContactList.isSupportedField(int) pour vérifier que l'élément prend en charge le type de champ.
    • Appelez ContactList.isSupportedAttribute(int, int) pour vérifier que le champ prend en charge l'attribut indiqué.
    • Appelez PIMList.maxValues(int field) pour vérifier le nombre de valeurs pris en charge par le champ.
  7. Appelez Contact.commit() pour valider les modifications.
    if(contact.isModified())
    {
        contact.commit();
    }
  8. Recherchez toute exception PIMException et ControlledAccessException si votre application n'est pas autorisée à accéder à l'application appelée.

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