Compartir a través de

Función GetThemeBackgroundContentRect (uxtheme.h)

  • Artículo

Recupera el tamaño del área de contenido para el fondo definido por el estilo visual.

Sintaxis

HRESULT GetThemeBackgroundContentRect(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pBoundingRect,
  [out] LPRECT  pContentRect
);

Parámetros

[in] hTheme

Tipo: HTHEME

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

[in] hdc

Tipo: HDC

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

[in] iPartId

Tipo: int

Valor de tipo int que especifica la parte que contiene el área de contenido. Vea Partes y estados.

[in] iStateId

Tipo: int

Valor de tipo int que especifica el estado de la parte que contiene el área de contenido. Vea Partes y estados.

[in] pBoundingRect

Tipo: LPCRECT

Puntero a una estructura RECT que contiene el rectángulo de fondo total, en coordenadas lógicas. Este es el área dentro de los bordes o márgenes.

[out] pContentRect

Tipo: LPRECT

Puntero a una estructura RECT que recibe el rectángulo de fondo del área de contenido, en coordenadas lógicas. Este rectángulo se calcula para ajustarse al área de contenido.

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

Un estilo visual puede definir un área de contenido dentro de cada imagen de fondo. Este es el área donde se puede colocar contenido como texto e iconos sin sobrescribir bordes de fondo.

Ejemplos

Al aplicar un tema a un área de cliente completa de una ventana, puede llamar a GetClientRect para recuperar esta área en un RECT, que se puede pasar a través del puntero como el parámetro pContentRect a GetThemeBackgroundContentRect como en el ejemplo siguiente.

DWORD resultFlags = GetThemeAppProperties();
bool ctrlsAreThemed = ((resultFlags & STAP_ALLOW_CONTROLS) != 0);

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

GetThemeBackgroundExtent

Identificadores de propiedad

Referencia