IInkAnalyzer：：CreateAnalysisHint 方法

将具有无限区域的新分析提示节点添加到 IInkAnalyzer。

语法

HRESULT CreateAnalysisHint(
  [out] IContextNode **ppAnalysisHint
);

parameters

ppAnalysisHint [out]

新的分析提示节点。

返回值

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

备注

注意

若要避免内存泄漏，请在不再需要使用 对象时在 ppAnalysisHint 上调用 IUnknown：：Release。

若要为 IInkAnalyzer 提供额外的上下文信息，可以将分析提示添加到墨迹分析器。 分析提示可以提高识别准确性。 例如，可以为表单应用程序中的字段添加 factoid 和指南信息。

此方法创建上下文节点类型为 AnalysisHint 的新 IContextNode ， (see IContextNode：：GetType) 并将新提示添加为 IInkAnalyzer 对象的根节点的子节点， (请参阅 IContextNode：：GetSubNodes 和 IInkAnalyzer：：GetRootNode 方法) 。

若要向提示添加上下文信息，请使用 IContextNode：：AddPropertyData， 并将 pPropertyDataId 参数设置为 分析提示属性 常量之一。

如果为某个提示分配了一个称为全局提示的无限区域， 则 IInkAnalyzer 会将提示的上下文应用于不在另一个提示区域内的所有墨迹。 多个提示可以附加到单个 IInkAnalyzer。 但是，只有一个全局提示可以附加到单个墨迹分析器，并且任何非全局提示都不能重叠。 有关提示可以提供的上下文信息类型的详细信息，请参阅 分析提示属性。

添加分析提示不会标记提示的重新分析区域。 若要标记提示中用于重新分析的区域，请使用 IInkAnalyzer：：SetDirtyRegion 方法将脏区域设置为分析提示的当前脏区域和区域的并集。

对表单应用程序使用提示时，应用程序应避免将文本上下文与表单中的墨迹混合使用。 例如，这意味着不应在分析树中创建文本字段名称。 提示旨在将墨迹关联到页面上的区域;任何文本上下文都会干扰此墨迹到提示关联。 分析操作可能会将墨迹和文本上下文合并到同一写入区域中，从而阻止墨迹与提示区域相关联。

有关墨迹分析的详细信息，请参阅 墨迹分析概述。

要求

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

另请参阅

IInkAnalyzer

IContextNode：：AddPropertyData

IInkAnalyzer：:D eleteAnalysisHint 方法

IInkAnalyzer：：GetAnalysisHints 方法

IInkAnalyzer：：GetAnalysisHintsByName 方法

分析提示属性

墨迹分析参考