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

こちらもご覧ください

プロパティ識別子