InkAnalyzer.CreateAnalysisHint Method (Rect)

Article
10/19/2012

Adds a new AnalysisHintNode with the specified area to the ink analyzer.

Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)

Syntax

'Declaration
Public Function CreateAnalysisHint ( _
    rectangle As Rect _
) As AnalysisHintNode
'Usage
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 function CreateAnalysisHint(
    rectangle : Rect
) : AnalysisHintNode

Parameters

rectangle
Type: System.Windows.Rect

Return Value

Type: System.Windows.Ink.AnalysisHintNode
The new AnalysisHintNode added to the ink analyzer.

Remarks

The ink analyzer adds the new AnalysisHintNode as a subnode of the analyzer's RootNode.

Adding an analysis hint does not mark the hint's area for reanalysis. To mark the area within the hint for reanalysis, call the DirtyRegion object's Union method with the hint's Location.

If a hint is assigned an infinite area, termed a global hint, the ink analyzer applies the hint's context to all ink that is not within another hint's area. Multiple hints may be attached to a single analyzer. However, only one global hint can be attached to a single ink analyzer, and the area of a non-global hint cannot overlap the global hint's area. For more information about the types of context information that a hint can provide, see AnalysisHintNode.

Examples

This example creates an AnalysisHintNode, named theAnalysisHint, for the InkAnalyzer, (named theInkAnalyzerWithHint). The new hint's area is set to the rectangle named theAnalysisRegion. It then sets the following properties on the hint:

' 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";

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0

Share via