ContactPickerUI Classe

Définition

Espace de noms:

Windows.ApplicationModel.Contacts.Provider

Vous permet d’appeler l’interface utilisateur du sélecteur de contacts pour pouvoir sélectionner un ou plusieurs contacts.

public ref class ContactPickerUI sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class ContactPickerUI final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class ContactPickerUI

Public NotInheritable Class ContactPickerUI

Héritage

Object Platform::Object IInspectable ContactPickerUI

Attributs

ContractVersionAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	contactsSystem

Exemples

Cet exemple de code prépare la page à utiliser ContactPickerUI :

ContactPickerUI contactPickerUI = MainPagePicker.Current.contactPickerUI;
CoreDispatcher dispatcher = Window.Current.Dispatcher;

public ContactPickerPage()
{
    this.InitializeComponent();
    ContactList.ItemsSource = contactSet;
    ContactList.SelectionChanged += ContactList_SelectionChanged;
}

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    contactPickerUI.ContactRemoved += contactPickerUI_ContactRemoved;
}

protected override void OnNavigatedFrom(NavigationEventArgs e)
{
    contactPickerUI.ContactRemoved -= contactPickerUI_ContactRemoved;
}

async void contactPickerUI_ContactRemoved(ContactPickerUI sender, ContactRemovedEventArgs args)
{
    // The event handler may be invoked on a background thread, so use the Dispatcher to run the UI-related code on the UI thread.
    string removedId = args.Id;
    await dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        foreach (SampleContact contact in ContactList.SelectedItems)
        {
            if (contact.Id == removedId)
            {
                ContactList.SelectedItems.Remove(contact);
                OutputText.Text += "\n" + contact.DisplayName + " was removed from the basket";
                break;
            }
        }
    });
}

Cet exemple de code montre comment ajouter un contact au panier avec la méthode AddContact(Contact).

switch (contactPickerUI.AddContact(contact))
{
    case AddContactResult.Added:
        // Notify the user that the contact was added
        OutputText.Text = contact.DisplayName + " was added to the basket";
        break;
    case AddContactResult.AlreadyAdded:
        // Notify the user that the contact is already added
        OutputText.Text = contact.DisplayName + " is already in the basket";
        break;
    case AddContactResult.Unavailable:
    default:
        // Notify the user that the basket is unavailable
        OutputText.Text = contact.DisplayName + " could not be added to the basket";
        break;
}

Cet exemple de code montre comment supprimer un contact du panier et répondre à sa suppression.

foreach (SampleContact removed in e.RemovedItems)
{
    if (contactPickerUI.ContainsContact(removed.Id))
    {
        contactPickerUI.RemoveContact(removed.Id);
        OutputText.Text = removed.DisplayName + " was removed from the basket";
    }
}

Remarques

Pour voir un exemple d’utilisation de cette classe, case activée notre exemple de code.

Propriétés

DesiredFields	Spécifie les champs que vous souhaitez retourner une fois que l’utilisateur a sélectionné un ou plusieurs contacts. Notes DesiredFields peut être modifié ou indisponible pour les versions après Windows 8.1. Utilisez plutôt DesiredFieldsWithContactFieldType.
DesiredFieldsWithContactFieldType	Obtient les champs avec le type de champ de contact que vous souhaitez retourner une fois que l’utilisateur a sélectionné un ou plusieurs contacts.
SelectionMode	Détermine le mode de sélection du sélecteur de contacts. Les options les plus courantes sont PickSingleContactAsync ou PickMultipleContactsAsync.

Méthodes

AddContact(Contact)	Ajoute un contact.
AddContact(String, Contact)	Ajoute un contact. Notes AddContact peut être modifié ou indisponible pour les versions après Windows 8.1. Au lieu de cela, utilisez AddContact sans l’ID.
ContainsContact(String)	Vérifie si le contact a déjà été sélectionné par l’utilisateur.
RemoveContact(String)	Supprime un contact.

Événements

ContactRemoved

Se produit lorsque l’utilisateur désélectionne ou supprime le contact.