IInkDisp：：HitTestWithLasso 方法 (msinkaut.h)

  • 项目

检索折线选择区域内的笔划。

语法

HRESULT HitTestWithLasso(
  [in]                VARIANT     Points,
  [in]                float       IntersectPercent,
  [in, out, optional] VARIANT     *LassoPoints,
  [out, retval]       IInkStrokes **Strokes
);

参数

[in] Points

选择工具中用于选择笔划的点。 选择区域是选择边界内的区域，该边界首先与边界本身相交。 如果边界本身不相交，方法会在数组的末尾添加一个点，以创建从第一个点到最后一个点的直线。 如果边界是直线， (选择边界) 内没有区域，则不会选择笔划。

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

[in] IntersectPercent

必须包含在选择工具中的笔划点的百分比，以便将笔划包含在生成的笔划集合中。 如果零 (0) ，则选择工具包含或相交的所有笔划都包含在生成的笔划集合中。 如果为 100，则集合中仅包含完全包含在选择工具中的笔划。 如果选择工具中包含的这些笔划中的点百分比大于或等于 percentIntersect 百分比，则与选择工具相交的笔划将包含在集合中。 小数百分比向上舍入。

[in, out, optional] LassoPoints

可选。 检索用于选择的选择工具的特定部分。 由于用户可以绘制许多不同类型的选择工具，其中一些工具会多次重叠，因此这可用于说明选择工具的哪个部分用于选择。 默认值为 NULL 指针，这意味着不返回任何信息。

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

[out, retval] Strokes

此方法返回时，包含指向构成墨迹的笔划集合的指针。

返回值

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

返回代码 说明
S_OK
 成功。
E_POINTER
 参数包含无效的指针。
E_INK_EXCEPTION
 方法内发生异常。
E_INVALIDARG
 显示句柄无效。
E_OUTOFMEMORY
 无法分配内存操作。

要求

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

另请参阅

HitTest (点，单) 方法

HitTest (Rectangle，单) 方法

IInkDisp

InkDisp 类

InkStrokes 集合