IInkStrokeDisp::Split 方法 (msinkaut.h)

在笔划的指定位置拆分笔划。

Syntax

HRESULT Split(
  [in]          float          SplitAt,
  [out, retval] IInkStrokeDisp **NewStroke
);

参数

[in] SplitAt

表示在何处拆分笔划的浮点索引值。

注意 浮点索引是一个浮点值,表示笔划中两个点之间的某个位置。 例如,如果 0.0 是笔划中的第一个点,1.0 是笔划中的第二个点,则 0.5 在第一和第二个点之间。 同样,浮点索引值为 37.25 表示沿笔划点 37 和 38 点之间的 25% 的位置。
 

[out, retval] NewStroke

此方法返回时,包含指向从拆分操作创建的新 IInkStrokeDisp 对象的指针。

返回值

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

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

注解

此方法紧接在笔划集中原始笔划之后插入新笔划,并重新编号剩余笔划索引。

拆分 IInkStrokeDisp 时,笔划的开头部分将保留原始 IInkStrokeDisp 的 ID。 IInkStrokeDisp 的结束部分将成为一个新的 IInkStrokeDisp,其 ID 大于最高 IInkStrokeDisp ID。 如果原始 IInkStrokeDisp 位于 InkStrokes 集合中(而不是 Ink.Strokes),则只有起始部分保留在该集合中。

要求

要求 价值
最低支持的客户端 Windows XP平板电脑版 [仅限桌面应用]
支持的最低服务器 无受支持的版本
目标平台 Windows
页眉 msinkaut.h

另见

IInkStrokeDisp 接口