Función DrawThemeParentBackgroundEx (uxtheme.h)

  • Artículo

Usado por controles secundarios parcialmente transparentes o alfamezados para dibujar la parte de su elemento primario delante del cual aparecen. Envía un mensaje WM_ERASEBKGND seguido de un WM_PRINTCLIENT.

Sintaxis

HRESULT DrawThemeParentBackgroundEx(
  [in] HWND       hwnd,
  [in] HDC        hdc,
  [in] DWORD      dwFlags,
  [in] const RECT *prc
);

Parámetros

[in] hwnd

Tipo: HWND

Identificador del control secundario.

[in] hdc

Tipo: HDC

HDC del control secundario.

[in] dwFlags

Tipo: DWORD

Cero o más de los siguientes valores. Si este valor es cero, esta función devuelve S_OK solo si el elemento primario controlado WM_PRINTCLIENT.

Valor Significado
DTPB_WINDOWDC
 Si se establece, se supone que hdc es un controlador de dominio de ventana, no un controlador de dominio cliente.
DTPB_USECTLCOLORSTATIC
 Si se establece, esta función envía un mensaje WM_CTLCOLORSTATIC al elemento primario y usa el pincel si se proporciona uno. De lo contrario, usa COLOR_BTNFACE.
DTPB_USEERASEBKGND
 Si se establece, esta función devuelve S_OK sin enviar un mensaje de WM_CTLCOLORSTATIC si el elemento primario realmente pintado en WM_ERASEBKGND.

[in] prc

Tipo: const RECT*

Opcional. Área que se va a dibujar, en coordenadas secundarias. Si este parámetro es NULL, el área que se va a dibujar incluye todo el área ocupada por el control secundario.

Valor devuelto

Tipo: HRESULT

S_OK si es correcto; de lo contrario, S_FALSE.

Requisitos

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