通过

GetThemeBitmap 函数 (uxtheme.h)

  • 项目

检索与特定主题、部件、状态和属性关联的位图。

语法

HRESULT GetThemeBitmap(
  [in]  HTHEME  hTheme,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  int     iPropId,
  [in]  ULONG   dwFlags,
  [out] HBITMAP *phBitmap
);

参数

[in] hTheme

类型： HTHEME

主题数据的句柄。

[in] iPartId

类型： int

包含位图的部件。 请参阅 部件和状态。

[in] iStateId

类型： int

部件的状态。

[in] iPropId

类型： int

要检索的属性。 传递零以自动选择此部件和状态的第一个可用位图，或使用以下值之一。

值 含义
TMT_DIBDATA
 背景图像。
TMT_GLYPHDIBDATA
 在背景之上绘制的字形图像（如果存在）。
TMT_HBITMAP
 当前不支持。

[in] dwFlags

类型： ULONG

指定如何检索位图的标志。 可以是以下值之一。

值 含义
GBF_DIRECT
 检索现有位图的句柄。
GBF_COPY
 检索位图的副本。
GBF_VALIDBITS
 | GBF_DIRECTGBF_COPY

[out] phBitmap

类型： HBITMAP*

接收所请求位图的句柄的指针。

返回值

类型： HRESULT

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

注解

如果 dwFlags 设置为 GBF_COPY，则通过调用 DeleteObject 释放存储在 phBitmap 中的位图（如果不再需要）。

要求

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