RecognizerContext.Strokes Property
RecognizerContext.Strokes Property |
Gets or sets the Strokes collection associated with the RecognizerContext object.
Definition
Visual Basic .NET Public Property Strokes As Strokes C# public Strokes Strokes { get; set; } Managed C++ public: __property Strokes* get_Strokes();
public: __property void set_Strokes(Strokes*);
Property Value
Microsoft.Ink.Strokes. The Strokes collection associated with the RecognizerContext object.
This property is read/write. This property has no default value.
Exceptions
ObjectDisposedException
: The RecognizerContext object is disposed.
Remarks
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 guides, factoids, 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.
Note: 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.
Examples
[C#]
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;[Visual Basic .NET]
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
See Also