Metodo IContactManagerInterop::ShowContactCardForWindow (shobjidl_core.h)

Articolo
03/02/2024

Visualizza l'interfaccia utente per un contatto nella finestra specificata.

Sintassi

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

Parametri

[in] appWindow

Tipo: HWND

HWND della finestra in primo piano dell'app da cui viene avviata la scheda contatto e dove viene restituito lo stato attivo quando la scheda contatto viene chiusa.

[in] contact

Tipo: IUnknown*

Puntatore all'oggetto contatto. Usa un oggetto Windows.ApplicationModel.Contacts.Contact, ma esegui il cast a IUnknown qui perché iDL COM classico non può usare i tipi di Windows Runtime.

[in] selection

Tipo: RECT const*

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 tale area rettangolare. Ad esempio, se un'app usa un pulsante per visualizzare la scheda contatto, passare il rect del pulsante in modo che la scheda contatto venga visualizzata intorno al pulsante, non sovrapposta.

[in] preferredPlacement

Tipo: FLYOUT_PLACEMENT

Valore tipizzato FLYOUT_PLACEMENT che descrive il posizionamento preferito della scheda contatto.

Valore	Significato
FP_DEFAULT 0	Usare quello predefinito.
FP_ABOVE 1	Preferisce posizionare la scheda contatto sopra l'area rettangolare della selezione utente specificata dal parametro di selezione .
FP_BELOW 2	Preferisce posizionare la scheda contatto sotto l'area rettangolare della selezione utente specificata dal parametro di selezione .
FP_LEFT 3	Preferisce posizionare la scheda contatto a sinistra dell'area rettangolare della selezione utente specificata dal parametro di selezione .
FP_RIGHT 4	Preferisce posizionare la scheda contatto a destra dell'area rettangolare della selezione utente specificata dal parametro di selezione .

Valore restituito

Tipo: HRESULT

ShowContactCardForWindow restituisce:

S_OK se la scheda contatto viene visualizzata correttamente
E_POINTER se appWindow è NULL o il contatto è NULL o la selezione è NULL
E_INVALIDARG se il contatto non è un oggetto Windows.ApplicationModel.Contacts.Contact o preferredPlacement è un valore di enumerazione non valido

Sono possibili altri valori HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h

Vedi anche

IContactManagerInterop

ShowContactCardForWindow

Condividi tramite