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

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

[in] dwFlags

类型： ULONG

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

[out] phBitmap

类型： HBITMAP*

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

返回值

类型： HRESULT

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

注解

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

要求