IInkStrokeDisp：：Clip 方法 (msinkaut.h)

  • 项目

删除位于矩形外部的 IInkStrokeDisp 对象或 InkStrokes 集合的部分。

语法

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

parameters

[in] Rectangle

指定在外边剪裁笔划或笔划的矩形。 矩形在墨迹空间坐标中指定。

返回值

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

返回代码 说明
S_OK
 成功。
E_POINTER
 参数包含无效的指针。
REGDB_CLASSNOTREG
 InkDisp 对象未注册。
E_INVALIDARG
 剪辑矩形无效。
E_INK_EXCEPTION
 方法内发生异常。
E_FAIL
 发生了未指定的错误。

注解

对于 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

请参阅

HitTest (Rectangle，单) 方法

IInkStrokeDisp 接口

InkRectangle 类