Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

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

Uxtheme.h

Library

UxTheme.lib

DLL

UxTheme.dll

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.