ContactPickerUI Kelas

Referensi

Definisi

Ruang nama:: Windows.ApplicationModel.Contacts.Provider

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Memungkinkan Anda memanggil UI pemilih kontak sehingga Anda dapat memilih satu atau beberapa kontak.

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

Warisan: Object Platform::Object IInspectable ContactPickerUI

Atribut: ContractVersionAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
Kemampuan aplikasi	contactsSystem

Contoh

Contoh kode ini menyiapkan halaman untuk menggunakan 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;
            }
        }
    });
}

Contoh kode ini menunjukkan cara menambahkan kontak ke kerak dengan metode 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;
}

Contoh kode ini menunjukkan cara menghapus kontak dari kerangkeng dan merespons penghapusannya.

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

Keterangan

Untuk melihat contoh cara menggunakan kelas ini, lihat sampel kode kami.

Properti

DesiredFields	Menentukan bidang yang ingin Anda kembalikan setelah pengguna memilih satu atau beberapa kontak. Catatan DesiredFields dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan DesiredFieldsWithContactFieldType.
DesiredFieldsWithContactFieldType	Mendapatkan bidang dengan tipe bidang kontak yang ingin Anda kembalikan setelah pengguna memilih satu atau beberapa kontak.
SelectionMode	Menentukan mode pemilihan untuk pemilih kontak. Opsi yang paling umum adalah PickSingleContactAsync atau PickMultipleContactsAsync.

Metode

AddContact(Contact)	Menambahkan Kontak.
AddContact(String, Contact)	Menambahkan Kontak. Catatan AddContact dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan AddContact tanpa ID.
ContainsContact(String)	Memeriksa untuk melihat apakah kontak sudah dipilih oleh pengguna.
RemoveContact(String)	Menghapus kontak.

Acara

ContactRemoved

Terjadi ketika pengguna membatalkan pilihan atau menghapus kontak.

Berlaku untuk

Bagikan melalui