nf-uxtheme-drawthemeparentbackgroundex.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:uxtheme.DrawThemeParentBackgroundEx	DrawThemeParentBackgroundEx function (uxtheme.h)	Used by partially-transparent or alpha-blended child controls to draw the part of their parent in front of which they appear. Sends a WM_ERASEBKGND message followed by a WM_PRINTCLIENT.	DTPB_USECTLCOLORSTATIC DTPB_USEERASEBKGND DTPB_WINDOWDC DrawThemeParentBackgroundEx DrawThemeParentBackgroundEx function [Windows Controls] _shell_DrawThemeParentBackgroundEx _shell_DrawThemeParentBackgroundEx_cpp controls.DrawThemeParentBackgroundEx controls._shell_DrawThemeParentBackgroundEx uxtheme/DrawThemeParentBackgroundEx	controls\DrawThemeParentBackgroundEx.htm	Controls	VS|Controls|~\controls\userex\functions\drawthemeparentbackgroundex.htm	12/05/2018	DTPB_USECTLCOLORSTATIC, DTPB_USEERASEBKGND, DTPB_WINDOWDC, DrawThemeParentBackgroundEx, DrawThemeParentBackgroundEx function [Windows Controls], _shell_DrawThemeParentBackgroundEx, _shell_DrawThemeParentBackgroundEx_cpp, controls.DrawThemeParentBackgroundEx, controls._shell_DrawThemeParentBackgroundEx, uxtheme/DrawThemeParentBackgroundEx	uxtheme.h		Windows	Windows Vista [desktop apps only]	Windows Server 2008 [desktop apps only]										UxTheme.lib	UxTheme.dll		Windows			19H1	DrawThemeParentBackgroundEx uxtheme/DrawThemeParentBackgroundEx	c++	APIRef kbSyntax	DllExport	UxTheme.dll	DrawThemeParentBackgroundEx

DrawThemeParentBackgroundEx function

-description

Used by partially-transparent or alpha-blended child controls to draw the part of their parent in front of which they appear. Sends a WM_ERASEBKGND message followed by a WM_PRINTCLIENT.

-parameters

-param hwnd [in]

Type: HWND

Handle of the child control.

-param hdc [in]

Type: HDC

HDC of the child control.

-param dwFlags [in]

Type: DWORD

Zero or more of the following values. If this value is zero, this function returns S_OK only if the parent handled WM_PRINTCLIENT.

Value	Meaning
DTPB_WINDOWDC	If set, hdc is assumed to be a window DC, not a client DC.
DTPB_USECTLCOLORSTATIC	If set, this function sends a WM_CTLCOLORSTATIC message to the parent and uses the brush if one is provided. Otherwise, it uses COLOR_BTNFACE.
DTPB_USEERASEBKGND	If set, this function returns S_OK without sending a WM_CTLCOLORSTATIC message if the parent actually painted on WM_ERASEBKGND.

-param prc [in]

Type: const RECT*

Optional. The area to be drawn, in child coordinates. If this parameter is NULL, the area to be drawn includes the entire area occupied by the child control.

-returns

Type: HRESULT

S_OK if successful; otherwise, S_FALSE.