InkAnalyzer.CreateAnalysisHint メソッド (Rect)

2008-10-28

指定された領域を持つ新しい AnalysisHintNode をインクアナライザに追加します。

名前空間 : System.Windows.Ink
アセンブリ : IAWinFX (IAWinFX.dll 内)

構文

'宣言
Public Function CreateAnalysisHint ( _
    rectangle As Rect _
) As AnalysisHintNode
'使用
Dim instance As InkAnalyzer
Dim rectangle As Rect
Dim returnValue As AnalysisHintNode

returnValue = instance.CreateAnalysisHint(rectangle)

public AnalysisHintNode CreateAnalysisHint(
    Rect rectangle
)

public:
AnalysisHintNode^ CreateAnalysisHint(
    Rect rectangle
)

public AnalysisHintNode CreateAnalysisHint(
    Rect rectangle
)

public function CreateAnalysisHint(
    rectangle : Rect
) : AnalysisHintNode

パラメータ

rectangle
型 : System.Windows.Rect

戻り値

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

解説

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

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

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

例

この例では、(theInkAnalyzerWithHint という名前の) InkAnalyzer の theAnalysisHint という名前の AnalysisHintNode を作成します。新しいヒントの領域が theAnalysisRegion という名前の四角形に設定されます。次に、ヒントで次のプロパティを設定します。

' Add a new analysis hint to theInkAnalyzer.
Dim theAnalysisHint As AnalysisHintNode = Me.theInkAnalyzer.CreateAnalysisHint(theAnalysisRegion.GetBounds())

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

// Add a new analysis hint to theInkAnalyzer.
AnalysisHintNode theAnalysisHint =
    this.theInkAnalyzer.CreateAnalysisHint(theAnalysisRegion.GetBounds());

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