ContactPicker Class

Contrôle comment l'interface utilisateur du sélecteur de contact s'ouvre et les informations qu'elle affiche.

Syntaxe


var contactPicker = new Windows.ApplicationModel.Contacts.ContactPicker();

Attributs

[Version(0x06020000)]

Membres

ContactPickerClasse possède ces types de membres :

Constructeurs

ContactPickerClasse possède ces constructeurs.

ConstructeurDescription
ContactPicker Creates a new instance of the ContactPicker class.

 

Méthodes

The ContactPicker Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
PickContactAsync Launches the Contact Picker to select a single contact.
PickContactsAsync Launches the Contact Picker for selecting multiple contacts.
PickMultipleContactsAsync PickMultipleContactsAsync may be altered or unavailable for releases after Windows 8.1. Instead, use PickContactsAsync. Launches the Contact Picker for selecting multiple contacts.
PickSingleContactAsync PickSingleContactAsync may be altered or unavailable for releases after Windows 8.1. Instead, use PickContactAsync. Launches the Contact Picker for selecting a single contact.

 

Propriétés

Le ContactPickerClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

CommitButtonText

Lecture/écritureSets the text for the confirmation button in the Contact Picker user interface.

DesiredFields

En lecture seuleDesiredFields may be altered or unavailable for releases after Windows 8.1. Instead, use DesiredFieldsWithContactFieldType. Sets the contact fields your app is interested in.

DesiredFieldsWithContactFieldType

En lecture seuleGets the ways to connect with a contact.

SelectionMode

Lecture/écritureControls whether the Contact Picker shows contacts as a complete entity or as a collection of fields.

 

Remarques

La classe ContactPicker permet aux utilisateurs de sélectionner un ou plusieurs contacts dans toute application qui prend en charge le contrat du sélecteur de contact. Vous pouvez configurer la classe ContactPicker pour accepter uniquement un contact unique ou plusieurs contacts. En outre, vous pouvez demander que l'application fournissant les informations de contact retourne le jeu de données complet pour chaque contact, ou simplement des champs spécifiques.

Remarque  Les applications qui ont été compilées pour Windows 8 mais qui s'exécutent sur Windows 8.1 peuvent rencontrer des erreurs d'exécution sans erreurs de compilation.

Exemples

Cet exemple illustre comment utiliser ContactPicker pour obtenir le nom et l'adresse électronique d'un seul contact.



function selectContact() {
    // Create the picker
    var picker = new Windows.ApplicationModel.Contacts.ContactPicker();
    picker.commitButtonText = "Select";
    picker.selectionMode = Windows.ApplicationModel.Contacts.ContactSelectionMode.fields;
    picker.desiredFieldsWithContactFieldType.append(Windows.ApplicationModel.Contacts.ContactFieldType.email);    

    // Open the picker for the user to select a contact
    picker.pickContactAsync().done(function (contact) {
        var contactElement = document.createElement("div");
        contactElement.innerText = contact.name + " " + contact.emails[0].address;
        document.body.appendChild(contactElement);
    });
}



Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.ApplicationModel.Contacts
Windows::ApplicationModel::Contacts [C++]

Métadonnées

Windows.winmd

Voir aussi

Exemple d'application de sélecteur de contact

 

 

Afficher:
© 2015 Microsoft