Méthode IContactManagerInterop ::ShowContactCardForWindow (shobjidl_core.h)

Article
08/26/2023

Affiche l’interface utilisateur d’un contact dans la fenêtre spécifiée.

Syntaxe

HRESULT ShowContactCardForWindow(
  [in] HWND             appWindow,
  [in] IUnknown         *contact,
  [in] const RECT       *selection,
  [in] FLYOUT_PLACEMENT preferredPlacement
);

Paramètres

[in] appWindow

Type : HWND

HWND de la fenêtre de premier plan de l’application à partir de laquelle le carte de contact est lancé et où le focus est retourné lorsque le carte de contact est ignoré.

[in] contact

Type : IUnknown*

Pointeur vers l’objet contact. Utilisez un objet Windows.ApplicationModel.Contacts.Contact, mais convertissez en IUnknown ici, car l’IDL COM classique ne peut pas utiliser Windows Runtime types.

[in] selection

Type : RECT const*

Rect est la zone rectangulaire de 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 le rect du bouton afin que le contact carte s’affiche autour du bouton, sans le chevaucher.

[in] preferredPlacement

Type : FLYOUT_PLACEMENT

Valeur de type FLYOUT_PLACEMENT qui décrit l’emplacement préféré du carte de contact.

Valeur	Signification
FP_DEFAULT 0	Utilisez la valeur par défaut.
FP_ABOVE 1	Préférez placer le contact carte au-dessus de la zone rectangulaire de sélection utilisateur spécifiée par le paramètre de sélection.
FP_BELOW 2	Préférez placer le contact carte sous la zone rectangulaire de sélection utilisateur spécifiée par le paramètre de sélection.
FP_LEFT 3	Préférez placer le contact carte à gauche de la zone rectangulaire de sélection de l’utilisateur spécifiée par le paramètre de sélection.
FP_RIGHT 4	Préférez placer le contact carte à droite de la zone rectangulaire de sélection de l’utilisateur spécifiée par le paramètre de sélection.

Valeur retournée

Type : HRESULT

ShowContactCardForWindow retourne :

S_OK si le carte de contact s’affiche correctement
E_POINTER si appWindow a la valeur NULL ou si le contact a la valeur NULL ou si la sélection a la valeur NULL
E_INVALIDARG si contact n’est pas un objet Windows.ApplicationModel.Contacts.Contact ou si preferredPlacement est une valeur d’énumération non valide

D’autres valeurs HRESULT sont possibles.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h

Voir aussi

IContactManagerInterop

ShowContactCardForWindow

Partager via