ContactPickerUI Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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. |