iInkStrokeDisp::Split 方法 (msinkaut.h)

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

语法

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 大 1。 如果原始 IInkStrokeDisp 位于 InkStrokes 集合中, (Ink.Strokes) ,则只有起始部分保留在该集合中。

要求

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

另请参阅

IInkStrokeDisp 接口