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

请参阅

函数