IInkRecognizerContext::get_Strokes method (msinkaut.h)

Article
02/22/2024

Gets or sets the InkStrokes collection associated with the InkRecognizerContext object.

This property is read/write.

Syntax

HRESULT get_Strokes(
  IInkStrokes **Strokes
);

Parameters

Strokes

Return value

None

Remarks

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

The InkStrokes collection can also be set to NULL, which also resets the InkRecognizerContext object. When the InkRecognizerContext is reset, it keeps any guides, factoids, and other properties which previously had been set on it.

When the InkRecognizerContext object is reset, any recognition taking place on the background thread is canceled.

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

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

Requirements

Requirement	Value
Minimum supported client	Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	msinkaut.h
Library	InkObj.dll