IContextNode::ReparentStrokeByIdToNode 方法

将笔划数据从此 IContextNode 移动到指定的 IContextNode

语法

HRESULT ReparentStrokeByIdToNode(
  [in] LONG         lStrokeId,
  [in] IContextNode *pContextNodeDestination
);

参数

lStrokeId [in]

要移动的笔划的标识符。

pContextNodeDestination [in]

要向其移动笔划数据的 IContextNode 对象。

返回值

有关返回值的说明,请参阅 类和接口 - 墨迹分析

备注

指定的 IContextNode 对象必须是 上下文节点 类型常量中的下列类型之一: InkWordInkDrawingInkBulletUnclassifiedInk。 尝试将笔划移动到任何其他类型的 IContextNode 对象会导致返回值 E_INVALIDARG

可以从任何 IContextNode 对象(包括非墨迹叶 IContextNode 对象)调用此方法。 指定的笔划必须由此 IContextNode 对象的后代之一引用, 否则将返回E_INVALIDARG

如果确认此 IContextNodepContextNodeDestination 中的 IContextNode则返回E_INVALIDARG (请参阅 IContextNode::IsConfirmed) 。

墨迹分析器不会从结果树中删除空上下文节点以响应此方法。

  • 不引用任何笔划数据的墨迹叶节点是空节点。
  • 不引用任何子节点的容器节点是空节点。

如果空节点在墨迹分析操作期间位于树中,则会生成错误。 若要从墨迹分析器的树中删除节点,请调用父节点的 IContextNode::D eleteSubNode 方法 (请参阅 IContextNode::GetParentNode) 。

要求

要求
最低受支持的客户端
Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器
无受支持的版本
标头
IACom.h (还需要 IACom_i.c)
DLL
IACom.dll

另请参阅

IContextNode

IContextNode::SetStrokes

墨迹分析参考