GetThemeStream 関数 (uxtheme.h)

指定した部分、状態、およびプロパティから始まる、指定したテーマに対応するデータ ストリームを取得します。

構文

HRESULT GetThemeStream(
  [in]  HTHEME    hTheme,
  [in]  int       iPartId,
  [in]  int       iStateId,
  [in]  int       iPropId,
  [out] VOID      **ppvStream,
  [out] DWORD     *pcbStream,
  [in]  HINSTANCE hInst
);

パラメーター

[in] hTheme

種類: HTHEME

ストリームの取得元となるテーマを処理します。

[in] iPartId

型: int

ストリームを取得するパーツを指定します。 「パーツと状態」を参照してください。

[in] iStateId

型: int

パーツの状態を指定します。

[in] iPropId

型: int

取得するプロパティを指定します。

[out] ppvStream

型: VOID**

ストリームを受信するポインターのアドレス。

[out] pcbStream

種類: DWORD*

ppvStream によって受信されたストリームの長さをバイト単位で受け取るポインター。

[in] hInst

種類: HINSTANCE

iPropId がTMT_STREAM場合、この値は NULL です。 iPropId がTMT_DISKSTREAM場合、この値は読み込まれたスタイル ファイルの HINSTANCE になります。

戻り値

種類: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

Windows 8: ハイ コントラスト モードでは、hTheme テーマ ハンドルが閉じられた後に、この関数によって取得されたデータ ストリームが無効になります。

この関数によって取得されるデータ ストリームはコピーではありません。を使用した後、データ ストリームを削除または閉じないでください。

要件

こちらもご覧ください

Parts and States (パーツと状態)