InkAnalyzerBase.CreateAnalysisHint 方法

项目
11/04/2008

将新的具有空区域的分析提示添加到墨迹分析器。

命名空间： System.Windows.Ink.AnalysisCore
程序集： IACore（在 IACore.dll 中）

语法

声明
Public Function CreateAnalysisHint As ContextNodeBase
用法
Dim instance As InkAnalyzerBase
Dim returnValue As ContextNodeBase

returnValue = instance.CreateAnalysisHint()

public ContextNodeBase CreateAnalysisHint()

public:
ContextNodeBase^ CreateAnalysisHint()

public ContextNodeBase CreateAnalysisHint()

public function CreateAnalysisHint() : ContextNodeBase

返回值

类型：System.Windows.Ink.AnalysisCore.ContextNodeBase
新的分析提示。

备注

若要为墨迹分析器提供额外上下文信息，可以将分析提示添加到墨迹分析器。分析提示可以提高识别准确性。例如，在窗体应用程序中可以为字段添加智能标记和指导信息。

此方法创建 Type 属性值为 AnalysisHint() 的新 ContextNodeBase，并将新提示添加到墨迹分析器的 RootNode 的 SubNodes 集合。

若要将上下文信息添加到提示，请使用 ContextNodeBase 对象的 AddPropertyData 方法，并将 propertyDataId 参数设置为 PropertyGuidsForAnalysisHintsBase 类中的全局唯一标识符 (GUID) 之一。

如果将某个提示分配给无限区域（称为全局提示），则墨迹分析器将该提示的上下文应用于不在其他提示的区域内的所有墨迹。一个分析器可以附加多个提示。但是，一个墨迹分析器只能附加一个全局提示，并且任何非全局提示均不可重叠。有关提示可以提供的上下文信息类型的更多信息，请参见 PropertyGuidsForAnalysisHintsBase。

添加分析提示不会将该提示的区域标记为需要重新分析。若要将提示内的区域标记为需要重新分析，请通过该提示的 Location 调用 DirtyRegion 对象的 Union 方法。

有关墨迹分析的更多信息，请参见Ink Analysis Overview。

示例

下面的示例为 InkAnalyzerBase (theInkAnalyzerBase) 创建分析提示 theAnalysisHint。然后将 theAnalysisHint 设置为全局提示，并将 AllowPartialDictionaryTerms 和 Name 属性添加到该提示。

' Add a new, global analysis hint to the ink analyzer. 
Dim theAnalysisHintNode As System.Windows.Ink.AnalysisCore.ContextNodeBase = _
    theInkAnalyzerBase.CreateAnalysisHint()
theAnalysisHintNode.Location.MakeInfinite()
theAnalysisHintNode.AddPropertyData( _
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.AllowPartialDictionaryTerms, _
    True)
theAnalysisHintNode.AddPropertyData( _
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.Name, _
    "Allow Partial Dictionary Terms")

// Add a new, global analysis hint to the ink analyzer. 
System.Windows.Ink.AnalysisCore.ContextNodeBase theAnalysisHintNode =
    theInkAnalyzerBase.CreateAnalysisHint();
theAnalysisHintNode.Location.MakeInfinite();
theAnalysisHintNode.AddPropertyData(
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.AllowPartialDictionaryTerms,
    true);
theAnalysisHintNode.AddPropertyData(
    System.Windows.Ink.AnalysisCore.PropertyGuidsForAnalysisHintsBase.Name,
    "Allow Partial Dictionary Terms");