This documentation is archived and is not being maintained.

RecognizerContext.Strokes Property

Gets or sets the Strokes collection associated with the RecognizerContext object.

Namespace:  Microsoft.Ink
Assembly:  Microsoft.Ink (in Microsoft.Ink.dll)

public Strokes Strokes { get; set; }

Property Value

Type: Microsoft.Ink.Strokes
The Strokes collection associated with the RecognizerContext object.

You must assign a Strokes collection to a RecognizerContext object in order for the RecognizerContext object to perform handwriting recognition. This property maintains the Strokes collection from which the RecognizerContext object creates the RecognitionResult object.

You can set the Strokes collection more than once. Each time you set the Strokes collection, the RecognizerContext object is reset—any ink or results are removed and any prior calls to the EndInkInput method are disregarded—and then the new strokes are added.

The Strokes collection can also be set to null, which also resets the RecognizerContext object. When the RecognizerContext is reset, it keeps any recognition guide, factoid, and other properties which previously had been set on it.

When the RecognizerContext object is reset, any recognition taking place on the background thread is cancelled.

To keep the Strokes property of the RecognizerContext object synchronized with the strokes associated with an Ink object, use the InkAdded and InkDeleted events of the Ink object to listen for strokes that should be added or removed from the Strokes collection assigned to the RecognizerContext object. This covers cases where strokes are added to, deleted from, clipped, or split within the Ink object.

NoteNote:

Moving, scaling, or other transformations on strokes in the Ink object do not generate InkAdded or InkDeleted events. Perform the same transformations on the strokes in the RecognizerContext object to keep the Strokes property of the RecognizerContext object synchronized.

This C# example removes the Strokes property of a RecognizerContext object, theRecognizerContext, to reset the RecognizerContext object without affecting its other properties.

theRecognizerContext.Strokes = null;

This Microsoft® Visual Basic® .NET example removes the Strokes property of a RecognizerContext object, theRecognizerContext, to reset the RecognizerContext object without affecting its other properties.

theRecognizerContext.Strokes = Nothing

Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008

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.

.NET Framework

Supported in: 3.0
Show: