ContactPickerUI Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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. |