DrawThemeParentBackgroundEx function (uxtheme.h)

  • Article

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.

Syntax

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

Parameters

[in] hwnd

Type: HWND

Handle of the child control.

[in] hdc

Type: HDC

HDC of the child control.

[in] dwFlags

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.

[in] prc

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.

Return value

Type: HRESULT

S_OK if successful; otherwise, S_FALSE.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header uxtheme.h
Library UxTheme.lib
DLL UxTheme.dll