OpenThemeDataEx 関数 (uxtheme.h)

  • [アーティクル]

指定したテーマ クラスのウィンドウに関連付けられているテーマ データを開きます。

構文

HTHEME OpenThemeDataEx(
  [in] HWND    hwnd,
  [in] LPCWSTR pszClassList,
  [in] DWORD   dwFlags
);

パラメーター

[in] hwnd

種類: HWND

テーマの取得元となるウィンドウまたはコントロールへのハンドル。

[in] pszClassList

種類: LPCWSTR

一致するクラス名のセミコロン区切りのリスト。

[in] dwFlags

種類: DWORD

テーマ データを返す方法を制御する省略可能なフラグ。 次の値の組み合わせに設定できます。

値 説明
OTD_FORCE_RECT_SIZING
 描画関数で指定された四角形に合わせて、このテーマから描画されたイメージを強制的に拡大します。
OTD_NONCLIENT
 テーマ要素をウィンドウのクライアント以外の領域に描画できるようにします。

戻り値

種類: HTHEME

一致するものが見つかった場合は、テーマに対する有効なハンドルが返されます。 それ以外の場合は、 NULL 値が返されます。

解説

pszClassIdList で指定された文字列は、区切り記号としてセミコロンを使用してトークン化されます。 名前は、一度に 1 つのトークンのクラス名と一致します。 特定のトークンに一致するものが見つからない場合は、次のトークンが一致します。 一致が見つかった場合、関数の戻り値は、一致するクラスに関連付けられているテーマ ハンドルになります。

Aero テーマのクラス名は、AeroStyle.xml で定義されます。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー uxtheme.h
Library UxTheme.lib
[DLL] UxTheme.dll

関連項目

OpenThemeData