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 |
| Library | User32.lib |
| DLL | User32.dll |