Compartir a través de

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

  • Artículo

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 Significado
FP_DEFAULT
0
 Use el valor predeterminado.
FP_ABOVE
1
 Prefiere colocar la tarjeta de contacto encima del área rectangular de la selección del usuario especificada por el parámetro de selección .
FP_BELOW
2
 Prefiere colocar la tarjeta de contacto debajo del área rectangular de la selección de usuario especificada por el parámetro de selección .
FP_LEFT
3
 Prefiere colocar la tarjeta de contacto a la izquierda del área rectangular de la selección de usuario especificada por el parámetro de selección .
FP_RIGHT
4
 Prefiere colocar la tarjeta de contacto a la derecha del área rectangular de la selección de usuario especificada por el parámetro de selección .

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.
Otros valores HRESULT son posibles.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h

Consulte también

IContactManagerInterop

ShowContactCardForWindow