InkAnalyzerBase.CreateAnalysisHint 方法

發行項
10/29/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");