IContextNode::Confirm 方法

修改确认类型,该类型控制 IInkAnalyzer 对象可以更改 IContextNode 的内容

语法

HRESULT Confirm(
  [in] ConfirmationType confirmedType
);

parameters

confirmedType [in]

应用于节点的 ConfirmationType

返回值

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

备注

使用此方法可让最终用户确认 IInkAnalyzer 已正确分析笔划。 调用 IContextNode::Confirm 后, IInkAnalyzer 不会在以后的分析中更改这些笔划的 IContextNode 对象。

当用户已确认分析结果且不希望 IInkAnalyzer 在以后的分析期间更改 IContextNode 时,请使用 IContextNode::Confirm。 例如,如果用户写入单词“to”,然后应用程序调用 IInkAnalyzer::Analyze 方法,则墨迹分析器将生成值为“to”的 InkWord 节点。 如果用户随后在“to”后面添加“me”作为一个单词,并且应用程序再次调用 IInkAnalyzer::Analyze 方法 ,则墨迹分析器可能会删除以前的 InkWord 节点并创建值为“tome”的新 InkWord 节点。 但是,如果在首次调用 IInkAnalyzer::Analyze 方法后,应用程序在 InkWord 节点上调用“to”的 IContextNode::Confirm 作为“to”,则在用户添加“me”之前,当应用程序调用 IInkAnalyzer::Analyze 方法时,墨迹分析器不会删除或更改“to”节点。 墨迹分析器可以识别“to”和“me”的两个 InkWord 节点。

IContextNode 只能确认 InkWord 和 InkDrawing 类型的对象, (请参阅 上下文节点类型) 。 当节点不是叶节点时,IContextNode::Confirm 返回E_INVALIDARG

IInkAnalyzer::RemoveStroke 方法和IInkAnalyzer::RemoveStrokes 方法 取消确认从中删除笔划数据的任何节点。

如果已确认 IContextNode 对象,则 IContextNode::SetStrokesIInkAnalyzer::SetStrokesType 和 IInkAnalyzer::SetStrokeType 返回CORE_E_INVALIDOPERATION

如果确认源节点或目标节点,IContextNode::ReparentStrokeByIdToNode 将返回错误。

要求

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

请参阅

IContextNode

IContextNode::IsConfirmed

墨迹分析参考