ShowContactCard(Contact, Rect, Placement) | metodo showContactCard(Contact, Rect, Placement)

ContactManager.ShowContactCard(Contact, Rect, Placement) | showContactCard(Contact, Rect, Placement) Method

Esegue una query nel sistema operativo per il contatto di un utente e visualizza i dati del contatto in una scheda del contatto.

Sintassi


Windows.ApplicationModel.Contacts.ContactManager.showContactCard(contact, selection, preferredPlacement);

Parametri

contact

Type: Contact

L'oggetto che rappresenta il contatto per il quale l'applicazione vuole visualizzare la scheda del contatto.

Nell'oggetto contact deve essere inclusa ameno una proprietà Id, una proprietà Emails o un numero di telefono da un elenco di Phones per eseguire una query sul database di contatti dell'utente per recuperare un contatto corrispondente da visualizzare. Id ha priorità più alta per eseguire la query. Se Id corrisponde, il resto dei parametri della query verranno ignorati per scopi di corrispondenza. Se Id non trova una corrispondenza, la query utilizza il resto dei parametri della query. Emails e Phones hanno uguale priorità di corrispondenza. Se vengono forniti più indirizzi di posta elettronica o numeri di telefono o entrambi, la query in primo luogo esegue una corrispondenza esatta, richiedendo tutti i parametri query per trovare la corrispondenza a un record di contatto del sistema. Se non viene restituita alcuna corrispondenza, la query utilizza la migliore corrispondenza possibile, in cui è sufficiente una corrispondenza di un parametro qualsiasi della query.

Se non si verifica alcuna occorrenza, i dati nel contatto di input vengono visualizzati nella scheda del contatto. Se si verifica una corrispondenza, vengono visualizzati solo i dati del contatto di sistema e i dati del contatto di input vengono eliminati.

selection

Type: Rect

Rect è l'area rettangolare della selezione utente, ad esempio premendo un pulsante, intorno a cui viene visualizzata la scheda di contatto, non all'interno di quell'area rettangolare. Ad esempio, se tramite un'applicazione viene utilizzato un pulsante per visualizzare la scheda contatto, passare l'oggetto Rect del pulsante in modo che la scheda in questione venga visualizzata intorno al pulsante, senza sovrapporlo.

preferredPlacement

Type: Placement

Placement che descrive la posizione preferita della scheda contatto.

Note

Ai fini dell'esecuzione di query, i numeri di telefono supportano caratteri 0-9 e a-z/A-Z. Se si inserisce qualsiasi altro carattere in un numero di telefono, verrà ignorato quando si esegue una query sul contatto.

Requisiti

Client supportato minimo

Windows 8.1

Server supportato minimo

Windows Server 2012 R2

Spazio dei nomi

Windows.ApplicationModel.Contacts
Windows::ApplicationModel::Contacts [C++]

Metadati

Windows.winmd

Vedere anche

ContactManager
IContactManagerInterop::ShowContactCardForWindow
ShowContactCard(Contact, Rect)

 

 

Mostra:
© 2016 Microsoft