InkAnalyzer.CreateAnalysisHint メソッド (Rectangle)

2008-10-28

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

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

構文

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

returnValue = instance.CreateAnalysisHint(analysisHintRectangle)

public AnalysisHintNode CreateAnalysisHint(
    Rectangle analysisHintRectangle
)

public:
AnalysisHintNode^ CreateAnalysisHint(
    Rectangle analysisHintRectangle
)

public AnalysisHintNode CreateAnalysisHint(
    Rectangle analysisHintRectangle
)

public function CreateAnalysisHint(
    analysisHintRectangle : Rectangle
) : AnalysisHintNode

パラメータ

analysisHintRectangle
型 : System.Drawing.Rectangle
ヒントの場所に設定される四角形。

戻り値

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

解説

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

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

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

例

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

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

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

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

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