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

Muestra la interfaz de usuario de un contacto en la ventana especificada.

Sintaxis

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

Parámetros

[in] appWindow

Tipo: HWND

HWND de la ventana de primer plano de la aplicación desde la que se inicia la tarjeta de contacto y dónde se devuelve el foco cuando se descarta la tarjeta de contacto.

[in] contact

Tipo: IUnknown*

Puntero al objeto de contacto. Usa un objeto Windows.ApplicationModel.Contacts.Contact, pero convierte a IUnknown aquí porque el IDL com clásico no puede usar Windows Runtime tipos.

[in] selection

Tipo: RECT const*

El rect es el área rectangular de la selección del usuario (por ejemplo, presionar un botón), alrededor del cual el sistema operativo muestra la tarjeta de contacto, no dentro de ese área rectangular. Por ejemplo, si una aplicación usa un botón para mostrar la tarjeta de contacto, pase la corrección del botón para que la tarjeta de contacto se muestre alrededor del botón, no superpuesta.

[in] preferredPlacement

Tipo: FLYOUT_PLACEMENT

Valor FLYOUT_PLACEMENT tipado que describe la ubicación preferida de la tarjeta de contacto.

Valor devuelto

Tipo: HRESULT

ShowContactCardForWindow devuelve:

• S_OK si la tarjeta de contacto se muestra correctamente
• E_POINTER si appWindow es NULL o el contacto es NULL o la selección es NULL.
• E_INVALIDARG si el contacto no es un objeto Windows.ApplicationModel.Contacts.Contact o preferredPlacement es un valor de enumeración no válido.

Requisitos

Consulte también

IContactManagerInterop

ShowContactCardForWindow