HitTestThemeBackground 関数 (uxtheme.h)
ビジュアル スタイルで指定された背景のポイントのヒット テスト コードを取得します。
構文
HRESULT HitTestThemeBackground(
[in] HTHEME hTheme,
[in] HDC hdc,
[in] int iPartId,
[in] int iStateId,
[in] DWORD dwOptions,
[in] LPCRECT pRect,
[in] HRGN hrgn,
[in] POINT ptTest,
[out] WORD *pwHitTestCode
);
パラメーター
[in] hTheme
種類: HTHEME
ウィンドウの指定されたテーマ データを処理します。 OpenThemeData を使用して HTHEME を作成します。
[in] hdc
種類: HDC
描画時に使用する HDC。 このパラメーターは NULL に設定できます。
[in] iPartId
型: int
パーツを指定する int 型の値。 「パーツと状態」を参照してください。
[in] iStateId
型: int
パーツの状態を指定する int 型の値。 「パーツと状態」を参照してください。
[in] dwOptions
型: DWORD
ヒット テスト オプションを指定する DWORD。 オプションの一覧については、「 ヒット テスト オプション」を参照してください。
[in] pRect
型: LPCRECT
背景を境界とする四角形を論理座標で含む RECT 構造体へのポインター。
[in] hrgn
種類: HRGN
ヒット テスト領域の境界を指定するために使用できる領域へのハンドル。 このパラメーターは NULL に設定できます。
[in] ptTest
種類: POINT
ポイント の座標を含む POINT 構造体。
[out] pwHitTestCode
種類: WORD*
ptTest のポイントが pRect または hrgn で囲まれた背景領域にあるかどうかを示すヒット テスト コードを受け取る WORD。 返される値の一覧については、「 ヒット テストの戻り 値」を参照してください。
戻り値
型: HRESULT
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
注釈
ptTest と pRect の値は、クライアントや画面などの同じ座標系に配置する必要があります。 hrgn パラメーターを使用する場合は、pRect および ptTest と同じ座標で指定する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | uxtheme.h |
| Library | UxTheme.lib |
| [DLL] | UxTheme.dll |