DrawThemeBackgroundEx function
[DrawThemeBackgroundEx is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
Draws the background image defined by the visual style for the specified control part.
Syntax
HRESULT DrawThemeBackgroundEx( _In_ HTHEME hTheme, _In_ HDC hdc, _In_ int iPartId, _In_ int iStateId, _In_ const RECT *pRect, _In_ const DTBGOPTS *pOptions );
Parameters
- hTheme [in]
-
Type: HTHEME
Handle to a window's specified theme data. Use OpenThemeData to create an HTHEME.
- hdc [in]
-
Type: HDC
HDC used for drawing the theme-defined background image.
- iPartId [in]
-
Type: int
Value of type int that specifies the part to draw. See Parts and States.
- iStateId [in]
-
Type: int
Value of type int that specifies the state of the part to draw. See Parts and States.
- pRect [in]
-
Type: const RECT*
Pointer to a RECT structure that contains the rectangle, in logical coordinates, in which the background image is drawn.
- pOptions [in]
-
Type: const DTBGOPTS*
Pointer to a DTBGOPTS structure that contains clipping information. This parameter may be set to NULL.
Return value
Type: HRESULT
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
Drawing operations are scaled to fit and to not exceed the rectangle specified in pRect.
Requirements
|
Minimum supported client | Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
Send comments about this topic to Microsoft
Build date: 10/27/2012
