EvaluateProximityToRect 関数 (winuser.h)

タッチ接触領域と交差する他のすべての四角形と比較して、四角形のスコアをタッチターゲットとして返し、四角形内の調整されたタッチ ポイントを返します。

構文

BOOL EvaluateProximityToRect(
  [in]  const RECT                             *controlBoundingBox,
  [in]  const TOUCH_HIT_TESTING_INPUT          *pHitTestingInput,
  [out] TOUCH_HIT_TESTING_PROXIMITY_EVALUATION *pProximityEval
);

パラメーター

[in] controlBoundingBox

UI 要素の境界ボックスを定義する RECT 構造体。

[in] pHitTestingInput

タッチ接触領域のデータを保持する TOUCH_HIT_TESTING_INPUT 構造。

[out] pProximityEval

スコアと調整されたタッチ ポイント データを保持する TOUCH_HIT_TESTING_PROXIMITY_EVALUATION 構造。

戻り値

この関数が成功すると、TRUE が返されます。

それ以外の場合は、FALSE を返します。 拡張エラー情報を取得するには、 GetLastError 関数を呼び出します。

解説

Windows との一貫性を確保するために、 WM_TOUCHHITTESTING を処理するフレームワークでは、ターゲット設定に次の原則を使用する必要があります。

• 包含: タッチ ポイントがコントロールの境界内にある場合、タッチ ポイントは変更されません。
• 交差: 接触ジオメトリと交差するコントロールのみを含めます。
• Z オーダー: 複数のコントロールが接触ジオメトリと交差し、コントロールが重なっている場合、z オーダーで最も高いコントロールが優先されます。
• あいまいさ: 複数のコントロールが接触ジオメトリと交差し、コントロールが重なっていない場合、元のタッチ ポイントに最も近いコントロールが優先されます。

要件

サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	winuser.h
Library	User32.lib
[DLL]	User32.dll

関連項目

関数