InkAnalyzer.CreateAnalysisHint メソッド

2008-10-28

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

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink.Analysis (Microsoft.Ink.Analysis.dll 内)

構文

'宣言
Public Function CreateAnalysisHint As AnalysisHintNode
'使用
Dim instance As InkAnalyzer
Dim returnValue As AnalysisHintNode

returnValue = instance.CreateAnalysisHint()

public AnalysisHintNode CreateAnalysisHint()

public:
AnalysisHintNode^ CreateAnalysisHint()

public AnalysisHintNode CreateAnalysisHint()

public function CreateAnalysisHint() : AnalysisHintNode

戻り値

型 : Microsoft.Ink.AnalysisHintNode
インクアナライザに追加される新しい AnalysisHintNode。

解説

インクアナライザは、新しい AnalysisHintNode を、アナライザの RootNode のサブノードとして追加します。

分析ヒントを追加しても、再分析対象としてヒントの領域がマークされることはありません。分析のヒント内で領域をマークするには、ヒントの Location を使用して DirtyRegion オブジェクトの Union を呼び出します。

新しい AnalysisHintNode は、その Location プロパティが更新されるまで空の領域を表します。

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

例

この例では、InkAnalyzer、theInkAnalyzerWithHint の AnalysisHintNode、theAnalysisHint を作成し、theAnalysisHint をグローバルヒントにします。次に、ヒントで次のプロパティを設定します。

' Add a new, global analysis hint to theInkAnalyzerWithHint.
Dim theAnalysisHint As Microsoft.Ink.AnalysisHintNode = _
    Me.theInkAnalyzerWithHint.CreateAnalysisHint()
theAnalysisHint.Location.MakeInfinite()

theAnalysisHint.AllowPartialDictionaryTerms = True
theAnalysisHint.Name = "Allow Partial Dictionary Terms"

// Add a new, global analysis hint to theInkAnalyzerWithHint.
Microsoft.Ink.AnalysisHintNode theAnalysisHint =
    this.theInkAnalyzerWithHint.CreateAnalysisHint();
theAnalysisHint.Location.MakeInfinite();

theAnalysisHint.AllowPartialDictionaryTerms = true;
theAnalysisHint.Name = "Allow Partial Dictionary Terms";