iInkDisp：：HitTestCircle 方法 (msinkaut.h)

  • 项目

检索完全位于已知圆圈内部或相交的 InkStrokes 集合。

语法

HRESULT HitTestCircle(
  [in]          long        X,
  [in]          long        Y,
  [in]          float       radius,
  [out, retval] IInkStrokes **Strokes
);

参数

[in] X

命中测试圆中心的 x 位置（以墨迹空间单位为单位）。

[in] Y

命中测试圆中心的 y 位置（以墨迹空间单位为单位）。

[in] radius

要用于命中测试的圆的半径，以墨迹空间单位表示。

[out, retval] Strokes

此方法返回时，包含完全位于指定圆内部或与指定圆相交的笔划集合。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
 成功。
E_POINTER
 参数包含无效指针。
E_INK_EXCEPTION
 方法内发生异常。
E_INVALIDARG
 无效的显示句柄。
E_UNEXPECTED
 意外的参数或属性类型。

注解

如果笔划与圆相交，则返回完整的笔划。

该方法计算交集，并考虑应用于笔划的完整绘图属性集，包括全笔宽度、贝塞尔平滑 (（如果存在) ）和笔尖的形状。

在对笔划或笔划集合执行旋转或切变后，转换后的 x- 和 y- 坐标不再与原始坐标同心。 因此， radius 不应从 x- 或 y- 坐标计算参数。

若要确定已知笔划的哪些点与测试区域相交，请调用 IInkStrokeDisp 对象的 HitTest 方法。

应用程序必须始终传入生成的笔划集合的目标指针。 如果没有交集，则集合的计数为零。

要求

要求 值
最低受支持的客户端 Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 msinkaut.h
Library InkObj.dll

另请参阅

HitTest (Point[]，单) 方法

HitTest (Rectangle，单) 方法

IInkDisp

InkDisp 类

InkStrokes 集合