Compartir a través de

Función GetThemeBackgroundRegion (uxtheme.h)

  • Artículo

Calcula la región de un fondo normal o parcialmente transparente que está limitado por un rectángulo especificado.

Sintaxis

HRESULT GetThemeBackgroundRegion(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pRect,
  [out] HRGN    *pRegion
);

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 en el que se va a dibujar. El controlador de dominio usa el escalado de puntos por pulgada (PPP). Este parámetro se puede establecer en NULL.

[in] iPartId

Tipo: int

Valor de tipo int que especifica la parte que contiene la región. Vea Partes y estados.

[in] iStateId

Tipo: int

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

[in] pRect

Tipo: LPCRECT

Puntero a una estructura RECT que contiene, en coordenadas lógicas, el rectángulo especificado utilizado para calcular la región.

[out] pRegion

Tipo: HRGN*

Puntero al identificador de la región calculada.

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

El identificador de región devuelto por esta función debe liberarse cuando ya no sea necesario, mediante DeleteObject.

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

Otros recursos

Identificadores de propiedad

Referencia

Regiones