EvaluateProximityToPolygon 函式 (winuser.h)
傳回多邊形的分數，因為與與觸控接觸) 區域交集的所有其他多邊形相交的觸控目標 (，以及多邊形內調整的觸控點。
語法
BOOL EvaluateProximityToPolygon(
UINT32 numVertices,
[in] const POINT *controlPolygon,
[in] const TOUCH_HIT_TESTING_INPUT *pHitTestingInput,
[out] TOUCH_HIT_TESTING_PROXIMITY_EVALUATION *pProximityEval
);
參數
numVertices
多邊形中的頂點數目。 此值必須大於或等於 3。
這個值表示陣列的大小，如 controlPolygon 參數所指定。
[in] controlPolygon
定義UI元素圖形的 x-y 螢幕座標數位。
numVertices 參數會指定座標數目。
[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 |
| 程式庫 | User32.lib |
| Dll | User32.dll |