ContactPickerUI Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Contacts.Provider

Consente di chiamare l'interfaccia utente di selezione contatti in modo da poter selezionare uno o più contatti.

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

Ereditarietà

Object Platform::Object IInspectable ContactPickerUI

Attributi

ContractVersionAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	contactsSystem

Esempio

Questo codice di esempio prepara la pagina per l'uso di 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;
            }
        }
    });
}

Questo codice di esempio mostra come aggiungere un contatto al carrello con il metodo 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;
}

Questo codice di esempio illustra come rimuovere un contatto dal carrello e rispondere alla rimozione.

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

Commenti

Per un esempio di come usare questa classe, vedere l'esempio di codice.

Proprietà

DesiredFields	Specifica i campi che si desidera restituire dopo che l'utente seleziona uno o più contatti. Nota DesiredFields può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece DesiredFieldsWithContactFieldType.
DesiredFieldsWithContactFieldType	Ottiene i campi con il tipo di campo contatto che si desidera restituire dopo che l'utente seleziona uno o più contatti.
SelectionMode	Determina la modalità di selezione del contatto. Le opzioni più comuni sono PickSingleContactAsync o PickMultipleContactsAsync.

Metodi

AddContact(Contact)	Aggiunge un contatto.
AddContact(String, Contact)	Aggiunge un contatto. Nota AddContact può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece AddContact senza l'ID.
ContainsContact(String)	Verifica se il contatto è già stato selezionato dall'utente.
RemoveContact(String)	Rimuove un contatto.

Eventi

ContactRemoved

Si verifica quando l'utente deseleziona o rimuove il contatto.