GetThemeBackgroundExtent 函数 (uxtheme.h)

在给定内容区域的情况下，计算由视觉样式定义的背景的大小和位置。

语法

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

参数

[in] hTheme

类型： HTHEME

窗口的指定主题数据的句柄。 使用 OpenThemeData 创建 HTHEME。

[in] hdc

类型： HDC

绘制时要使用的 HDC。 此参数可以设置为 NULL。

[in] iPartId

类型： int

int 类型的值，指定包含内容的部件。 请参阅 部件和状态。

[in] iStateId

类型： int

int 类型的值，指定包含内容的部件的状态。 请参阅 部件和状态。

[in] pContentRect

类型： LPCRECT

指向包含内容背景矩形的 RECT 结构的指针，以逻辑坐标表示。 此矩形从 GetThemeBackgroundContentRect 返回。

[out] pExtentRect

类型： LPRECT

指向接收背景矩形的 RECT 结构的指针，以逻辑坐标表示。 此矩形基于 pContentRect。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

主题可以定义每个背景图像中的内容区域。 这是可在不覆盖背景边框的情况下放置文本和图标等内容的区域。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	uxtheme.h
Library	UxTheme.lib
DLL	UxTheme.dll

另请参阅

GetThemeBackgroundContentRect

属性标识符

引用