GetThemeBackgroundExtent function (uxtheme.h)

Calculates the size and location of the background, defined by the visual style, given the content area.

Syntax

HRESULT GetThemeBackgroundExtent(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pContentRect,
  [out] LPRECT  pExtentRect
);

Parameters

[in] hTheme

Type: HTHEME

Handle to a window's specified theme data. Use OpenThemeData to create an HTHEME.

[in] hdc

Type: HDC

HDC to use when drawing. This parameter may be set to NULL.

[in] iPartId

Type: int

Value of type int that specifies the part that contains the content. See Parts and States.

[in] iStateId

Type: int

Value of type int that specifies the state of the part that contains the content. See Parts and States.

[in] pContentRect

Type: LPCRECT

Pointer to a RECT structure that contains the content background rectangle, in logical coordinates. This rectangle is returned from GetThemeBackgroundContentRect.

[out] pExtentRect

Type: LPRECT

Pointer to a RECT structure that receives the background rectangle, in logical coordinates. This rectangle is based on the pContentRect.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

A theme can define a content area within each background image. This is the area where content such as text and icons can be placed without overwriting background borders.

Requirements

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

See also

GetThemeBackgroundContentRect

Property Identifiers

Reference