InkAnalyzer.AddStrokesToCustomRecognizer Method

Článek
10/19/2012

Adds stroke data for multiple strokes to a custom recognizer node.

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

Syntax

'Declaration
Public Function AddStrokesToCustomRecognizer ( _
    strokes As StrokeCollection, _
    customRecognizer As CustomRecognizerNode _
) As ContextNode
'Usage
Dim instance As InkAnalyzer 
Dim strokes As StrokeCollection 
Dim customRecognizer As CustomRecognizerNode 
Dim returnValue As ContextNode 

returnValue = instance.AddStrokesToCustomRecognizer(strokes, _
    customRecognizer)

public ContextNode AddStrokesToCustomRecognizer(
    StrokeCollection strokes,
    CustomRecognizerNode customRecognizer
)

public:
ContextNode^ AddStrokesToCustomRecognizer(
    StrokeCollection^ strokes, 
    CustomRecognizerNode^ customRecognizer
)

public function AddStrokesToCustomRecognizer(
    strokes : StrokeCollection, 
    customRecognizer : CustomRecognizerNode
) : ContextNode

Parameters

strokes
Type: System.Windows.Ink.StrokeCollection

The StrokeCollection to be added.

customRecognizer
Type: System.Windows.Ink.CustomRecognizerNode

The custom recognizer node to which the strokes are added.

Return Value

Type: System.Windows.Ink.ContextNode
The context node to which the ink analyzer added strokes.

Remarks

The InkAnalyzer adds strokes to a ContextNode with a Type property value of UnclassifiedInk.

During analysis, the ink analyzer assigns the locale identifier of the active input thread to the stroke and adds the stroke to the first unclassified ink node under the ink recognizer. If no unclassified node exists, it is created. If the custom recognizer does not support the locale identifier, the ink analyzer continues analyzing and generates an AnalysisWarning warning. This warning has its WarningCode property set to the AnalysisWarningCode value of LanguageIdNotRespected.

Only strokes with the same packet descriptions can be added in a single call to AddStrokes.

This method expands the DirtyRegion to the union of the region's current value and the bounding box of the added strokes.

The InkAnalyzer throws an exception under the following circumstances.

The InkAnalyzer already contains a stroke with the same identifier as one of the strokes to be added.
The customRecognizer parameter contains a ContextNode that is associated with a different InkAnalyzer object.
The customRecognizer parameter contains a ContextNode that does not have a Type property value of CustomRecognizer.

Examples

The following example adds the strokes from an InkCanvas to the CustomRecognizerNode, named theCustomRecognizerNode.

' Add the strokes to the specified CustomRecognizerNode. 
Me.theInkAnalyzer.AddStrokesToCustomRecognizer(theInkCanvas.Strokes, Me.theCustomRecognizerNode)

// Add the strokes to the specified CustomRecognizerNode. 
this.theInkAnalyzer.AddStrokesToCustomRecognizer(
    theInkCanvas.Strokes,
    this.theCustomRecognizerNode);

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

Sdílet prostřednictvím