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：：SetStrokes、IInkAnalyzer：：SetStrokesType 和 IInkAnalyzer：：SetStrokeType 返回CORE_E_INVALIDOPERATION。

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

要求

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

请参阅

IContextNode

IContextNode：：IsConfirmed

墨迹分析参考