IContextNode::ReparentStrokeByIdToNode 方法
将笔划数据从此 IContextNode 移动到指定的 IContextNode。
语法
HRESULT ReparentStrokeByIdToNode(
[in] LONG lStrokeId,
[in] IContextNode *pContextNodeDestination
);
参数
-
lStrokeId [in]
-
要移动的笔划的标识符。
-
pContextNodeDestination [in]
-
要向其移动笔划数据的 IContextNode 对象。
返回值
有关返回值的说明,请参阅 类和接口 - 墨迹分析。
备注
指定的 IContextNode 对象必须是 上下文节点 类型常量中的下列类型之一: InkWord、 InkDrawing、 InkBullet 或 UnclassifiedInk。 尝试将笔划移动到任何其他类型的 IContextNode 对象会导致返回值 E_INVALIDARG。
可以从任何 IContextNode 对象(包括非墨迹叶 IContextNode 对象)调用此方法。 指定的笔划必须由此 IContextNode 对象的后代之一引用, 否则将返回E_INVALIDARG 。
如果确认此 IContextNode 或 pContextNodeDestination 中的 IContextNode,则返回E_INVALIDARG (请参阅 IContextNode::IsConfirmed) 。
墨迹分析器不会从结果树中删除空上下文节点以响应此方法。
- 不引用任何笔划数据的墨迹叶节点是空节点。
- 不引用任何子节点的容器节点是空节点。
如果空节点在墨迹分析操作期间位于树中,则会生成错误。 若要从墨迹分析器的树中删除节点,请调用父节点的 IContextNode::D eleteSubNode 方法 (请参阅 IContextNode::GetParentNode) 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP Tablet PC Edition [仅限桌面应用] |
最低受支持的服务器 |
无受支持的版本 |
标头 |
|
DLL |
|