IInkStrokeDisp::GetRectangleIntersections 方法 (msinkaut.h)

查找 IInkStrokeDisp 对象与给定矩形相交的点。

语法

HRESULT GetRectangleIntersections(
  [in]          IInkRectangle *Rectangle,
  [out, retval] VARIANT       *Intersections
);

参数

[in] Rectangle

墨迹空间坐标中的矩形,用于描述命中测试区域。

[out, retval] Intersections

此方法返回时,包含一个 VARIANT 数组,该数组指示笔划与 矩形相交的位置。 起始浮点索引存储在偶数索引中。 结束浮点索引存储在奇数索引中。 第一对索引表示第一个交集。

有关 VARIANT 结构的详细信息,请参阅 使用 COM 库

返回值

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

返回代码 说明
S_OK
成功。
E_POINTER
参数包含无效的指针。
E_OUTOFMEMORY
无法分配 Stroke 处理程序帮助程序对象。
E_UNEXPECTED
意外的参数或属性类型。
E_INK_EXCEPTION
方法内发生异常。

注解

此方法返回一个数组,该数组指示笔划与指定矩形相交的位置。 与矩形相交的每个笔划段都是一对索引,与开始索引交替,后跟结束索引。

如果笔划在测试矩形内开始,则第一个索引设置为 -1。 如果笔划在测试矩形内结束,则最后一个索引设置为 -1。 如果笔划完全位于测试矩形之外,则返回空数组。 例如,如果笔划在测试矩形内开始,离开矩形的边界,返回内部,然后再次离开,则 GetRectangleIntersections 方法可能会返回 {-1, 1.4, 5.5, 10.1} 来描述位于矩形内的两段笔划。

要求

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

另请参阅

Clip 方法

FindIntersections 方法

IInkStrokeDisp 接口