ContactManager.ShowContactCard Metodo
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.
Overload
| ShowContactCard(Contact, Rect) |
Esegue una query sul sistema operativo per il contatto di un utente e visualizza i dati di contatto in una scheda contatto. |
| ShowContactCard(Contact, Rect, Placement) |
Esegue una query sul sistema operativo per il contatto di un utente e visualizza i dati di contatto in una scheda contatto. |
| ShowContactCard(Contact, Rect, Placement, ContactCardOptions) |
Mostra una scheda contatto con i parametri specificati. |
ShowContactCard(Contact, Rect)
Esegue una query sul sistema operativo per il contatto di un utente e visualizza i dati di contatto in una scheda contatto.
public:
static void ShowContactCard(Contact ^ contact, Rect selection);/// [Windows.Foundation.Metadata.Overload("ShowContactCard")]
static void ShowContactCard(Contact const& contact, Rect const& selection);[Windows.Foundation.Metadata.Overload("ShowContactCard")]
public static void ShowContactCard(Contact contact, Rect selection);function showContactCard(contact, selection)Public Shared Sub ShowContactCard (contact As Contact, selection As Rect)Parametri
- contact
- Contact
Oggetto che rappresenta il contatto per cui l'app vuole visualizzare la scheda contatto. il contatto deve contenere almeno un ID, messaggi di posta elettronica o un numero di telefono da un elenco Telefoni per eseguire una query sul database di contatto dell'utente per recuperare un contatto corrispondente da visualizzare. L'ID ha una priorità superiore per la query. Se corrisponde un ID , il resto dei parametri di query verrà ignorato ai fini della corrispondenza. Se un ID non trova una corrispondenza, la query usa il resto dei parametri di query. I messaggi di posta elettronica e i telefoni hanno la stessa priorità per la corrispondenza. Se vengono forniti più indirizzi di posta elettronica o numeri di telefono o entrambi, la query esegue prima una corrispondenza esatta, richiedendo che tutti i parametri di query corrispondano a un record di contatto di sistema. Se questo risultato non corrisponde, la query usa la corrispondenza "best effort", in cui una corrispondenza di qualsiasi parametro di query è sufficiente.
Se non si verificano corrispondenze, i dati nel contatto di input vengono visualizzati nella scheda contatto. Se si verifica una corrispondenza, vengono visualizzati solo i dati del contatto di sistema e i dati nel contatto di input vengono eliminati.
- selection
- Rect
Rect è l'area rettangolare della selezione utente (ad esempio, premendo un pulsante), intorno alla quale il sistema operativo visualizza la scheda contatto, non all'interno di quell'area rettangolare. Ad esempio, se un'app usa un pulsante per visualizzare la scheda contatto, passare il pulsante Rect del pulsante in modo che la scheda contatto venga visualizzata intorno al pulsante, non sovrapposta.
- Attributi
Requisiti Windows
| Funzionalità dell'app |
contactsSystem
|
Commenti
Nota
Le app di origine devono essere in esecuzione in primo piano per chiamare questo metodo. Un'app eseguita in background otterrà un'eccezione "Accesso negato" se chiama questo metodo.
La maggior parte delle operazioni tipiche comporta la visualizzazione di un'interfaccia utente.
- Se è presente una corrispondenza esatta per il contatto richiesto: Mostra l'interfaccia utente della scheda contatto con informazioni dall'archivio contatti nel sistema operativo.
- Se sono presenti più corrispondenze: Mostra l'interfaccia utente della scheda contatto per il primo contatto corrispondente trovato.
- Se non è presente alcuna corrispondenza: Mostra l'interfaccia utente della scheda contatto, in cui le informazioni di contatto provengono dall'oggetto contatto di input.
Se si verifica un errore, ad esempio un input non valido per il parametro di contatto , non viene visualizzata alcuna interfaccia utente.
A scopo di query, i numeri di telefono supportano i caratteri 0-9 e a-z/A-Z. Se si inseriscono altri caratteri in un numero di telefono, vengono ignorati quando si esegue una query sul contatto.
Per informazioni su come gestire i contatti, vedere Contatti e calendario.
A scopo di query, i numeri di telefono supportano i caratteri 0-9 e a-z/A-Z. Se si inseriscono altri caratteri in un numero di telefono, vengono ignorati quando si esegue una query sul contatto.
Vedi anche
Si applica a
ShowContactCard(Contact, Rect, Placement)
Esegue una query sul sistema operativo per il contatto di un utente e visualizza i dati di contatto in una scheda contatto.
public:
static void ShowContactCard(Contact ^ contact, Rect selection, Placement preferredPlacement);/// [Windows.Foundation.Metadata.Overload("ShowContactCardWithPlacement")]
static void ShowContactCard(Contact const& contact, Rect const& selection, Placement const& preferredPlacement);[Windows.Foundation.Metadata.Overload("ShowContactCardWithPlacement")]
public static void ShowContactCard(Contact contact, Rect selection, Placement preferredPlacement);function showContactCard(contact, selection, preferredPlacement)Public Shared Sub ShowContactCard (contact As Contact, selection As Rect, preferredPlacement As Placement)Parametri
- contact
- Contact
Oggetto che rappresenta il contatto per cui l'app vuole visualizzare la scheda contatto. il contatto deve contenere almeno un ID, messaggi di posta elettronica o un numero di telefono da un elenco Telefoni per eseguire una query sul database di contatto dell'utente per recuperare un contatto corrispondente da visualizzare. L'ID ha una priorità superiore per la query. Se corrisponde un ID , il resto dei parametri di query verrà ignorato ai fini della corrispondenza. Se un ID non trova una corrispondenza, la query usa il resto dei parametri di query. I messaggi di posta elettronica e i telefoni hanno la stessa priorità per la corrispondenza. Se vengono forniti più indirizzi di posta elettronica o numeri di telefono o entrambi, la query esegue prima una corrispondenza esatta, richiedendo che tutti i parametri di query corrispondano a un record di contatto di sistema. Se questo risultato non corrisponde, la query usa la corrispondenza "best effort", in cui una corrispondenza di qualsiasi parametro di query è sufficiente.
Se non si verificano corrispondenze, i dati nel contatto di input vengono visualizzati nella scheda contatto. Se si verifica una corrispondenza, vengono visualizzati solo i dati del contatto di sistema e i dati nel contatto di input vengono eliminati.
- selection
- Rect
Rect è l'area rettangolare della selezione utente (ad esempio, premendo un pulsante), intorno alla quale il sistema operativo visualizza la scheda contatto, non all'interno di quell'area rettangolare. Ad esempio, se un'app usa un pulsante per visualizzare la scheda contatto, passare il pulsante Rect del pulsante in modo che la scheda contatto venga visualizzata intorno al pulsante, non sovrapposta.
- preferredPlacement
- Placement
Posizionamento che descrive il posizionamento preferito della scheda contatto.
- Attributi
Requisiti Windows
| Funzionalità dell'app |
contactsSystem
|
Commenti
Vedere la sezione osservazioni di questo overload: ShowContactCard.
Vedi anche
- ShowContactCard(Contact, Rect)
- Esempio di API per la gestione dei contatti
- IContactManagerInterop.ShowContactCardForWindow
Si applica a
ShowContactCard(Contact, Rect, Placement, ContactCardOptions)
Mostra una scheda contatto con i parametri specificati.
public:
static void ShowContactCard(Contact ^ contact, Rect selection, Placement preferredPlacement, ContactCardOptions ^ contactCardOptions);/// [Windows.Foundation.Metadata.Overload("ShowContactCardWithOptions")]
static void ShowContactCard(Contact const& contact, Rect const& selection, Placement const& preferredPlacement, ContactCardOptions const& contactCardOptions);[Windows.Foundation.Metadata.Overload("ShowContactCardWithOptions")]
public static void ShowContactCard(Contact contact, Rect selection, Placement preferredPlacement, ContactCardOptions contactCardOptions);function showContactCard(contact, selection, preferredPlacement, contactCardOptions)Public Shared Sub ShowContactCard (contact As Contact, selection As Rect, preferredPlacement As Placement, contactCardOptions As ContactCardOptions)Parametri
- contact
- Contact
Oggetto che rappresenta il contatto per cui l'app vuole visualizzare la scheda contatto. il contatto deve contenere almeno un ID, messaggi di posta elettronica o un numero di telefono da un elenco Telefoni per eseguire una query sul database di contatto dell'utente per recuperare un contatto corrispondente da visualizzare. L'ID ha una priorità superiore per la query. Se corrisponde un ID , il resto dei parametri di query verrà ignorato ai fini della corrispondenza. Se un ID non trova una corrispondenza, la query usa il resto dei parametri di query. I messaggi di posta elettronica e i telefoni hanno la stessa priorità per la corrispondenza. Se vengono forniti più indirizzi di posta elettronica o numeri di telefono o entrambi, la query esegue prima una corrispondenza esatta, richiedendo che tutti i parametri di query corrispondano a un record di contatto di sistema. Se questo risultato non corrisponde, la query usa la corrispondenza "best effort", in cui una corrispondenza di qualsiasi parametro di query è sufficiente.
Se non si verificano corrispondenze, i dati nel contatto di input vengono visualizzati nella scheda contatto. Se si verifica una corrispondenza, vengono visualizzati solo i dati del contatto di sistema e i dati nel contatto di input vengono eliminati.
- selection
- Rect
Rect è l'area rettangolare della selezione utente (ad esempio, premendo un pulsante), intorno alla quale il sistema operativo visualizza la scheda contatto, non all'interno di quell'area rettangolare. Ad esempio, se un'app usa un pulsante per visualizzare la scheda contatto, passare il pulsante Rect del pulsante in modo che la scheda contatto venga visualizzata intorno al pulsante, non sovrapposta.
- preferredPlacement
- Placement
Posizionamento che descrive il posizionamento preferito della scheda contatto.
- contactCardOptions
- ContactCardOptions
Specifica come visualizzare la scheda contatto, ad esempio la scheda da avviare durante la visualizzazione di una scheda di contatto mini.
- Attributi
Requisiti Windows
| Funzionalità dell'app |
contactsSystem
|
Commenti
Vedere la sezione osservazioni di questo overload: ShowContactCard.