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

取得するプロパティ。 0 を渡して、この部分と状態で使用可能な最初のビットマップを自動的に選択するか、次のいずれかの値を使用します。

値 意味
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