Função DrawThemeParentBackgroundEx (uxtheme.h)

Artigo
03/13/2024

Usado por controles filho parcialmente transparentes ou combinados alfa para desenhar a parte do pai na frente da qual eles aparecem. Envia uma mensagem WM_ERASEBKGND seguida de um WM_PRINTCLIENT.

Sintaxe

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

Parâmetros

[in] hwnd

Tipo: HWND

Identificador do controle filho.

[in] hdc

Tipo: HDC

HDC do controle filho.

[in] dwFlags

Tipo: DWORD

Zero ou mais dos valores a seguir. Se esse valor for zero, essa função retornará S_OK somente se o pai tiver manipulado WM_PRINTCLIENT.

Valor	Significado
DTPB_WINDOWDC	Se definido, o hdc será considerado um DC de janela, não um DC cliente.
DTPB_USECTLCOLORSTATIC	Se definida, essa função enviará uma mensagem WM_CTLCOLORSTATIC para o pai e usará o pincel se for fornecido. Caso contrário, ele usa COLOR_BTNFACE.
DTPB_USEERASEBKGND	Se definida, essa função retornará S_OK sem enviar uma mensagem WM_CTLCOLORSTATIC se o pai realmente for pintado em WM_ERASEBKGND.

[in] prc

Tipo: const RECT*

Opcional. A área a ser desenhada, em coordenadas filho. Se esse parâmetro for NULL, a área a ser desenhada incluirá toda a área ocupada pelo controle filho.

Retornar valor

Tipo: HRESULT

S_OK se bem-sucedido; caso contrário, S_FALSE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uxtheme.h
Biblioteca	UxTheme.lib
DLL	UxTheme.dll

Share via