共用方式為

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
程式庫 UxTheme.lib
Dll UxTheme.dll