ContactManager.ShowContactCard Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| ShowContactCard(Contact, Rect) |
Interroge le système d’exploitation pour le contact d’un utilisateur et affiche les données de contact dans un carte de contact. |
| ShowContactCard(Contact, Rect, Placement) |
Interroge le système d’exploitation pour le contact d’un utilisateur et affiche les données de contact dans un carte de contact. |
| ShowContactCard(Contact, Rect, Placement, ContactCardOptions) |
Affiche un contact carte avec les paramètres spécifiés. |
ShowContactCard(Contact, Rect)
Interroge le système d’exploitation pour le contact d’un utilisateur et affiche les données de contact dans un carte de contact.
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)Paramètres
- contact
- Contact
Objet qui représente le contact pour lequel l’application souhaite afficher le contact carte.Le contact doit contenir au moins un ID, des e-mails ou un numéro de téléphone d’une liste Téléphones pour interroger la base de données de contacts de l’utilisateur afin de récupérer un contact correspondant à afficher. L’ID a une priorité plus élevée pour l’interrogation. Si un ID correspond, les autres paramètres de requête sont ignorés à des fins de correspondance. Si un ID ne trouve pas de correspondance, la requête utilise le reste des paramètres de requête. Les e-mails et les téléphones ont la même priorité pour la correspondance. Si plusieurs adresses e-mail, numéros de téléphone, ou les deux, sont fournis, la requête effectue d’abord une correspondance exacte, exigeant que tous les paramètres de requête correspondent à un enregistrement de contact système. Si cela n’entraîne aucune correspondance, la requête utilise la correspondance « best effort », dans laquelle une correspondance de tous les paramètres de requête est suffisante.
Si aucune correspondance ne se produit, les données du contact d’entrée s’affichent dans le carte de contact. Si une correspondance se produit, seules les données de contact système s’affichent et les données du contact d’entrée sont ignorées.
- selection
- Rect
Rect est la zone rectangulaire de la sélection de l’utilisateur (par exemple, en appuyant sur un bouton), autour de laquelle le système d’exploitation affiche le contact carte, et non dans cette zone rectangulaire. Par exemple, si une application utilise un bouton pour afficher le carte de contact, transmettez la valeur Rect du bouton afin que le contact carte s’affiche autour du bouton, sans le chevaucher.
- Attributs
Configuration requise pour Windows
| Fonctionnalités de l’application |
contactsSystem
|
Remarques
Notes
Les applications sources doivent être en cours d’exécution au premier plan pour appeler cette méthode. Une application qui s’exécute en arrière-plan obtient une exception « Accès refusé » si elle appelle cette méthode.
La plupart des opérations classiques entraînent l’affichage d’une interface utilisateur.
- S’il existe une correspondance exacte pour le contact demandé : Affiche l’interface utilisateur carte contact avec les informations du magasin de contacts dans le système d’exploitation.
- S’il existe plusieurs correspondances : Affiche l’interface utilisateur carte contact pour le premier contact correspondant trouvé.
- S’il n’y a pas de correspondance : Affiche l’interface utilisateur carte contact, où les informations de contact proviennent de l’objet contact d’entrée.
En cas d’erreur, telle qu’une entrée non valide pour le paramètre contact , aucune interface utilisateur n’est affichée.
À des fins d’interrogation, les numéros de téléphone prennent en charge les caractères 0-9 et a-z/A-Z. Si vous placez d’autres caractères dans un numéro de téléphone, ils sont ignorés lorsque vous interrogez le contact.
Pour plus d’informations sur la gestion des contacts, consultez Contacts et calendrier.
À des fins d’interrogation, les numéros de téléphone prennent en charge les caractères 0-9 et a-z/A-Z. Si vous placez d’autres caractères dans un numéro de téléphone, ils sont ignorés lorsque vous interrogez le contact.
Voir aussi
S’applique à
ShowContactCard(Contact, Rect, Placement)
Interroge le système d’exploitation pour le contact d’un utilisateur et affiche les données de contact dans un carte de contact.
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)Paramètres
- contact
- Contact
Objet qui représente le contact pour lequel l’application souhaite afficher le contact carte.Le contact doit contenir au moins un ID, des e-mails ou un numéro de téléphone d’une liste Téléphones pour interroger la base de données de contacts de l’utilisateur afin de récupérer un contact correspondant à afficher. L’ID a une priorité plus élevée pour l’interrogation. Si un ID correspond, les autres paramètres de requête sont ignorés à des fins de correspondance. Si un ID ne trouve pas de correspondance, la requête utilise le reste des paramètres de requête. Les e-mails et les téléphones ont la même priorité pour la correspondance. Si plusieurs adresses e-mail, numéros de téléphone, ou les deux, sont fournis, la requête effectue d’abord une correspondance exacte, exigeant que tous les paramètres de requête correspondent à un enregistrement de contact système. Si cela n’entraîne aucune correspondance, la requête utilise la correspondance « best effort », dans laquelle une correspondance de tous les paramètres de requête est suffisante.
Si aucune correspondance ne se produit, les données du contact d’entrée s’affichent dans le carte de contact. Si une correspondance se produit, seules les données de contact système s’affichent et les données du contact d’entrée sont ignorées.
- selection
- Rect
Rect est la zone rectangulaire de la sélection de l’utilisateur (par exemple, en appuyant sur un bouton), autour de laquelle le système d’exploitation affiche le contact carte, et non dans cette zone rectangulaire. Par exemple, si une application utilise un bouton pour afficher le carte de contact, transmettez la valeur Rect du bouton afin que le contact carte s’affiche autour du bouton, sans le chevaucher.
- Attributs
Configuration requise pour Windows
| Fonctionnalités de l’application |
contactsSystem
|
Remarques
Consultez la section remarques de cette surcharge : ShowContactCard.
Voir aussi
- ShowContactCard(Contact, Rect)
- Exemple d’API du Gestionnaire de contacts
- IContactManagerInterop.ShowContactCardForWindow
S’applique à
ShowContactCard(Contact, Rect, Placement, ContactCardOptions)
Affiche un contact carte avec les paramètres spécifiés.
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)Paramètres
- contact
- Contact
Objet qui représente le contact pour lequel l’application souhaite afficher le contact carte.Le contact doit contenir au moins un ID, des e-mails ou un numéro de téléphone d’une liste Téléphones pour interroger la base de données de contacts de l’utilisateur afin de récupérer un contact correspondant à afficher. L’ID a une priorité plus élevée pour l’interrogation. Si un ID correspond, les autres paramètres de requête sont ignorés à des fins de correspondance. Si un ID ne trouve pas de correspondance, la requête utilise le reste des paramètres de requête. Les e-mails et les téléphones ont la même priorité pour la correspondance. Si plusieurs adresses e-mail, numéros de téléphone, ou les deux, sont fournis, la requête effectue d’abord une correspondance exacte, exigeant que tous les paramètres de requête correspondent à un enregistrement de contact système. Si cela n’entraîne aucune correspondance, la requête utilise la correspondance « best effort », dans laquelle une correspondance de tous les paramètres de requête est suffisante.
Si aucune correspondance ne se produit, les données du contact d’entrée s’affichent dans le carte de contact. Si une correspondance se produit, seules les données de contact système s’affichent et les données du contact d’entrée sont ignorées.
- selection
- Rect
Rect est la zone rectangulaire de la sélection de l’utilisateur (par exemple, en appuyant sur un bouton), autour de laquelle le système d’exploitation affiche le contact carte, et non dans cette zone rectangulaire. Par exemple, si une application utilise un bouton pour afficher le carte de contact, transmettez la valeur Rect du bouton afin que le contact carte s’affiche autour du bouton, sans le chevaucher.
- contactCardOptions
- ContactCardOptions
Spécifie comment afficher le carte de contact, par exemple l’onglet sur lequel commencer lors de l’affichage d’un mini-contact carte.
- Attributs
Configuration requise pour Windows
| Fonctionnalités de l’application |
contactsSystem
|
Remarques
Consultez la section remarques de cette surcharge : ShowContactCard.