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 [仅限桌面应用] |
最低受支持的服务器 |
无受支持的版本 |
标头 |
|
DLL |
|