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 |