IContactManagerInterop::ShowContactCardForWindow-Methode (shobjidl_core.h)

Artikel
03/02/2024

Zeigt die Benutzeroberfläche für einen Kontakt im angegebenen Fenster an.

Syntax

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

Parameter

[in] appWindow

Typ: HWND

Die HWND des Vordergrundfensters der App, von der aus der Kontakt Karte gestartet wird, und in dem der Fokus zurückgegeben wird, wenn der Kontakt Karte geschlossen wird.

[in] contact

Typ: IUnknown*

Ein Zeiger auf das Kontaktobjekt. Verwenden Sie ein Windows.ApplicationModel.Contacts.Contact-Objekt, aber hier in IUnknown umgewandelt, da die klassische COM-IDL keine Windows-Runtime Typen verwenden kann.

[in] selection

Typ: RECT const*

Rect ist der rechteckige Bereich der Benutzerauswahl (z. B. drücken einer Taste), um den das Betriebssystem den Kontakt Karte anzeigt, nicht innerhalb dieses rechteckigen Bereichs. Wenn eine App beispielsweise eine Schaltfläche verwendet, um den Kontakt Karte anzuzeigen, übergeben Sie das Rect der Schaltfläche, damit der Kontakt Karte um die Schaltfläche herum angezeigt wird, ohne sie zu überlappen.

[in] preferredPlacement

Typ: FLYOUT_PLACEMENT

Ein FLYOUT_PLACEMENT typisierter Wert, der die bevorzugte Platzierung des Kontakts Karte beschreibt.

Wert	Bedeutung
FP_DEFAULT 0	Verwenden Sie den Standardwert.
FP_ABOVE 1	Platzieren Sie den Kontakt lieber Karte über dem rechteckigen Bereich der Benutzerauswahl, der durch den Auswahlparameter angegeben wird.
FP_BELOW 2	Platzieren Sie den Kontakt lieber Karte unterhalb des rechteckigen Bereichs der Benutzerauswahl, der durch den Auswahlparameter angegeben wird.
FP_LEFT 3	Platzieren Sie den Kontakt lieber Karte links neben dem rechteckigen Bereich der Benutzerauswahl, der durch den Auswahlparameter angegeben wird.
FP_RIGHT 4	Platzieren Sie den Kontakt lieber Karte rechts neben dem rechteckigen Bereich der Benutzerauswahl, der durch den Auswahlparameter angegeben wird.

Rückgabewert

Typ: HRESULT

ShowContactCardForWindow gibt Folgendes zurück:

S_OK, wenn der kontakt Karte erfolgreich angezeigt wird
E_POINTER, wenn appWindow NULL oder Kontakt NULL oder Auswahl NULL ist
E_INVALIDARG, wenn der Kontakt kein Windows.ApplicationModel.Contacts.Contact-Objekt ist oder preferredPlacement ein ungültiger Enumerationswert ist

Andere HRESULT-Werte sind möglich.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h

Weitere Informationen

IContactManagerInterop

ShowContactCardForWindow

Freigeben über