InkAnalyzer.CreateAnalysisHint メソッド

2008-10-28

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

名前空間 : System.Windows.Ink
アセンブリ : IAWinFX (IAWinFX.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

戻り値

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

解説

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

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

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

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

例

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

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

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

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

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