iInkDisp::D eleteStrokes 方法 (msinkaut.h)

InkDisp 对象的 Strokes 集合中删除 InkStrokes 集合。

语法

HRESULT DeleteStrokes(
  [in, optional] IInkStrokes *Strokes
);

参数

[in, optional] Strokes

可选。 指定要从 InkDisp 对象中删除的笔划的集合。 默认值为 NULL。

返回值

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

返回代码 说明
S_OK
成功。
E_POINTER
参数包含无效指针。
E_OUTOFMEMORY
无法分配用于执行操作的内存。
E_FAIL
发生了未指定的错误。
E_INK_MISMATCHED_INK_OBJECT
笔划的 InkDisp 对象必须与已知的 InkDisp 对象匹配。
E_INK_EXCEPTION
方法内发生异常。
E_UNEXPECTED
意外的参数或属性类型。

注解

如果未传入 InkStrokes 集合,此方法将删除 InkDisp 对象中的所有笔划。 若要一次仅删除一个笔划,请调用 DeleteStroke 方法。

如果已删除的笔划不在 InkDisp 对象的笔划集合的末尾,则 InkDisp 对象将重新编号 InkDisp 对象中剩余笔划的索引。

注意InkDisp 对象中删除集合中包含的笔划时,InkStrokes 集合的内容将变为无效。
 
如果在用户主动放置墨迹时调用 DeleteStrokes 可能会导致错误。

要求

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

另请参阅

DeleteStroke 方法

IInkDisp

InkDisp 类

InkStrokes 集合