Partager via


ContactPickerUI Classe

Définition

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

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.

S’applique à