ContactPickerUI Classe

Definição

Namespace:

Windows.ApplicationModel.Contacts.Provider

Permite que você chame a interface do usuário do seletor de contatos para que você possa selecionar um ou mais contatos.

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

Herança

Object Platform::Object IInspectable ContactPickerUI

Atributos

ContractVersionAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo	contactsSystem

Exemplos

Este código de exemplo prepara a página para usar 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;
            }
        }
    });
}

Este código de exemplo mostra como adicionar um contato à cesta com o método 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;
}

Este código de exemplo mostra como remover um contato da cesta e responder à sua remoção.

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

Comentários

Para ver um exemplo de como usar essa classe, marcar nosso exemplo de código.

Propriedades

DesiredFields	Especifica os campos que você deseja retornar depois que o usuário seleciona um ou mais contatos. Observação DesiredFields pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use DesiredFieldsWithContactFieldType.
DesiredFieldsWithContactFieldType	Obtém os campos com o tipo de campo de contato que você deseja retornar depois que o usuário seleciona um ou mais contatos.
SelectionMode	Determina o modo de seleção do seletor de contatos. As opções mais comuns são PickSingleContactAsync ou PickMultipleContactsAsync.

Métodos

AddContact(Contact)	Adiciona um Contato.
AddContact(String, Contact)	Adiciona um Contato. Observação AddContact pode ser alterado ou indisponível para versões após Windows 8.1. Em vez disso, use AddContact sem a ID.
ContainsContact(String)	Verifica se o contato já foi selecionado pelo usuário.
RemoveContact(String)	Remove um contato.

Eventos

ContactRemoved

Ocorre quando o usuário desmarca ou remove o contato.