删除位于矩形外部的 IInkStrokeDisp 对象或 InkStrokes 集合的部分。
语法
HRESULT Clip(
[in] IInkRectangle *Rectangle
);
参数
[in] Rectangle
指定剪裁笔划或笔划的矩形。 矩形在墨迹空间坐标中指定。
返回值
此方法可以返回其中一个值。
| 返回代码 | 说明 |
|---|---|
|
成功。 |
|
参数包含无效指针。 |
|
InkDisp 对象未注册。 |
|
无效的剪裁矩形。 |
|
方法内发生异常。 |
|
发生了未指定的错误。 |
注解
对于 InkDisp 对象,矩形相交的所有笔划在交点处拆分。 矩形外的所有笔划部分将从 InkDisp 对象中删除。 方法可以在笔划与矩形相交的点向笔划添加新点。 对 InkDisp 对象调用 Clip 方法后,InkDisp 对象的笔划集合中的笔划 ID 保证是唯一的,但不保证保留其他信息。
剪裁时,此方法不考虑笔宽度。 它仅剪裁实际墨迹或笔划数据。
对于 IInkStrokeDisp 对象或 InkStrokes 集合, Clip 方法更新父 InkDisp 对象。 每当从 InkDisp 对象中删除墨迹时,为该 InkDisp 对象定义的任何 IInkStrokeDisp 对象或 InkStrokes 集合都可能失效。
有关墨迹数据的详细信息,请参阅 墨迹数据。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP Tablet PC Edition [仅限桌面应用] |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | msinkaut.h |
| Library | InkObj.dll |