Función HitTestThemeBackground (uxtheme.h)

Recupera un código de prueba de posicionamiento para un punto en segundo plano especificado por un estilo visual.

Sintaxis

HRESULT HitTestThemeBackground(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  DWORD   dwOptions,
  [in]  LPCRECT pRect,
  [in]  HRGN    hrgn,
  [in]  POINT   ptTest,
  [out] WORD    *pwHitTestCode
);

Parámetros

[in] hTheme

Tipo: HTHEME

Identificador de los datos de tema especificados de una ventana. Use OpenThemeData para crear un HTHEME.

[in] hdc

Tipo: HDC

HDC que se usará al dibujar. Este parámetro se puede establecer en NULL.

[in] iPartId

Tipo: int

Valor de tipo int que especifica la parte. Vea Partes y estados.

[in] iStateId

Tipo: int

Valor de tipo int que especifica el estado de la parte. Vea Partes y estados.

[in] dwOptions

Tipo: DWORD

DWORD que especifica las opciones de prueba de posicionamiento. Consulte Opciones de prueba de posicionamiento para obtener una lista de opciones.

[in] pRect

Tipo: LPCRECT

Puntero a una estructura RECT que contiene, en coordenadas lógicas, el rectángulo que enlaza el fondo.

[in] hrgn

Tipo: HRGN

Identificador de una región que se puede usar para especificar los límites de un área de prueba de posicionamiento. Este parámetro se puede establecer en NULL.

[in] ptTest

Tipo: POINT

Estructura POINT que contiene las coordenadas del punto.

[out] pwHitTestCode

Tipo: WORD*

WORD que recibe el código de prueba de posicionamiento que indica si el punto de ptTest está en el área de fondo limitada por pRect o hrgn. Consulte Valores devueltos de la prueba de posicionamiento para obtener una lista de valores devueltos.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Los valores de ptTest y pRect deben estar en el mismo sistema de coordenadas, como el cliente o la pantalla. Si se usa el parámetro hrgn , debe especificarse en las mismas coordenadas que pRect y ptTest.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	uxtheme.h
Library	UxTheme.lib
Archivo DLL	UxTheme.dll

Consulte también

Identificadores de propiedad