RecognizerContext.Strokes Property
Gets or sets the Strokes collection associated with the RecognizerContext object.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public Property Strokes As Strokes
'Usage
Dim instance As RecognizerContext
Dim value As Strokes
value = instance.Strokes
instance.Strokes = value
public Strokes Strokes { get; set; }
public:
property Strokes^ Strokes {
Strokes^ get ();
void set (Strokes^ value);
}
public function get Strokes () : Strokes
public function set Strokes (value : Strokes)
Property Value
Type: Microsoft.Ink.Strokes
The Strokes collection associated with the RecognizerContext object.
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 nulla null reference (Nothing in Visual Basic), 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.
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
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
Platforms
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.
Version Information
.NET Framework
Supported in: 3.0