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
此方法返回时,包含指向构成墨迹的笔划集合的指针。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
成功。 |
|
参数包含无效的指针。 |
|
方法内发生异常。 |
|
显示句柄无效。 |
|
无法分配内存操作。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP Tablet PC Edition [仅限桌面应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | msinkaut.h |
Library | InkObj.dll |