Draws the part of a parent control that is covered by a partially-transparent or alpha-blended child control.
Syntax
HRESULT DrawThemeParentBackground(
HWND hwnd,
HDC hdc,
const RECT *prc
);
Parameters
- hwnd
-
[in] Handle of the child control.
- hdc
-
[in] Handle to the child control's device context (DC).
- prc
-
[in] Pointer to a >RECT structure that defines the area to be drawn. The rectangle is in the child window's coordinates. This parameter may be set to NULL.
Return Value
Returns S_OK if successful, or an error value otherwise.
Example
Prior to calling DrawThemeBackground to draw the background image for a window, you may call IsThemeBackgroundPartiallyTransparent. This method determines whether DrawThemeParentBackground should be called to draw in backgrounds behind partially-transparent or alpha-blended child controls, and is demonstrated in the following example.
if (_hTheme)
{
if (IsThemeBackgroundPartiallyTransparent(_hTheme, BP_PUSHBUTTON, _iStateId))
{
DrawThemeParentBackground(_hwnd, hdcPaint, prcPaint);
}
DrawThemeBackground(_hTheme,
hdcPaint,
BP_PUSHBUTTON,
_iStateId,
&rcClient,
prcPaint);
}
Function Information
| Stock Implementation | UxTheme.dll |
|---|
| Custom Implementation | No |
|---|
| Header | uxtheme.h |
|---|
| Import library | UxTheme.lib |
|---|
| Minimum operating systems |
Windows XP |
|---|