Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

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 Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Uxtheme.h

Library

UxTheme.lib

DLL

UxTheme.dll

 

 

Community Additions

ADD
Show:
© 2015 Microsoft