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

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 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

Configuration requise

Voir aussi

IContactManagerInterop

ShowContactCardForWindow