Collegamento di un contatto

È possibile collegare un contatto nell'applicazione a un contatto nell'applicazione Contatti del dispositivo BlackBerry. È possibile decidere come interagire con l'utente BlackBerry quando si collega un contatto. I seguenti passaggi descrivono un approccio possibile.
Prima di iniziare:
  1. Importare le classi e le interfacce richieste.
    import net.rim.blackberry.api.pdap.*;
    import net.rim.blackberry.api.pdap.contactlinking.*;
    import javax.microedition.pim.*;
  2. Verificare se nell'applicazione Contatti esiste un contatto (un oggetto BlackBerryContact) che può essere collegato come contatto. Il metodo LinkedContactUtilities.getContactLinkCandidate() restituisce un oggetto BlackBerryContact se nell'applicazione Contatti individua un contatto con lo stesso indirizzo e-mail o numero di telefono dell'oggetto LinkableContact che è stato passato. Se non esistono contatti corrispondenti, il metodo restituisce null.
    BlackBerryContact bbContact = 
        LinkedContactUtilities.getContactLinkCandidate(linkableContact);
  3. Se viene trovata una corrispondenza, collegare il contatto all'oggetto BlackBerryContact.
    bbContact = LinkedContactUtilities.linkContact(bbContact, linkableContact);
  4. Se non viene trovata una corrispondenza, l'utente deve selezionare nell'applicazione Contatti un contatto al quale collegare il contatto selezionato.
    BlackBerryContactList contacts = null;
    try
    {
        contacts = (BlackBerryContactList) PIM.getInstance().
            openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);
    }
    catch(PIMException e)
    {
        ContactLinkingDemo.errorDialog("Couldn't open contacts list.");   
        return;                 
    }
    Object choice = contacts.choose();
    if(choice instanceof BlackBerryContact)
    {
        bbContact = (BlackBerryContact)choice;
    }
  5. Verificare se il contatto selezionato nell'applicazione Contatti è già collegato a un contatto nell'applicazione.
    LinkedContactUtilities.isContactLinked(bbContact, 
        linkableContact.getApplicationID())
    
  6. Se il contatto selezionato nell'applicazione Contatti non è già collegato, collegarlo al contatto nell'applicazione.
    bbContact = LinkedContactUtilities.linkContact(bbContact, linkableContact);
    

Esempio di codice: collegamento di un contatto

Per un esempio di questo approccio al collegamento di un contatto, vedere linkContact() nell'applicazione di prova della demo di collegamento dei contatti inclusa in BlackBerry Java SDK.

Argomento successivo: Rimozione di un collegamento

Le informazioni sono state utili? Inviateci i vostri commenti.