ContactPickerUI Classe

Definizione

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

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.

Si applica a