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 順序中最高的控制項會收到優先順序。
• 模棱兩可：如果多個控制項與連絡人幾何交集，且控制項不會重迭，最接近原始觸控點的控制項會收到優先順序。

規格需求

請參閱

函式