InkAnalyzerBase.CreateAnalysisHint メソッド

2008-10-28

空の領域を持つ新しい分析のヒントをインクアナライザに追加します。

名前空間 : 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 コレクションに新しいヒントを追加します。

コンテキスト情報をヒントに追加するには、PropertyGuidsForAnalysisHintsBase クラスで propertyDataId パラメータがグローバル一意識別子 (GUID) の 1 つに設定された、ContextNodeBase オブジェクトの AddPropertyData メソッドを使用します。

ヒントに、グローバルヒントと呼ばれる無限領域が割り当てられた場合、インクアナライザはヒントのコンテキストを、別のヒントの領域内に含まれていないすべてのインクに適用します。1 つのアナライザには複数のヒントをアタッチすることができます。ただし、グローバルヒントは 1 つのインクアナライザに 1 つだけアタッチでき、グローバルヒント以外のヒントは重複することはできません。ヒントが提供可能なコンテキスト情報の種類の詳細については、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");