IInkRecognizerContext::Strokes
4/8/2010
Gets or sets the IInkStrokes collection associated with the IInkRecognizerContext object.
Syntax
[propputref] HRESULT putref_Strokes ([in] IInkStrokes *Strokes);
[propget] HRESULT get_Strokes ([out, retval] IInkStrokes **Strokes
);
Parameters
Strokes
The IInkStrokes collection associated with the IInkRecognizerContext object.This property is read/write.
Return Value
| HRESULT value | Description |
|---|---|
S_OK |
Success. |
E_FAIL |
An unspecified error occurred. |
E_INK_INCOMPATIBLE_OBJECT |
The object is incompatible with the application programming interface (API). |
E_OUTOFMEMORY |
Cannot allocate memory to complete the operation. |
E_POINTER |
The parameter is an invalid pointer. |
Remarks
You can set the IInkStrokes collection more than once. Each time you set the IInkStrokes collection, the IInkRecognizerContext object is reset—any ink or results are removed—and then the new strokes are added.
The IInkStrokes collection can also be set to NULL, which also resets the IInkRecognizerContext object. When the IInkRecognizerContext is reset, it keeps any guides, factoids, and other properties which previously had been set on it.
To keep the Strokes property synchronized with an IInkDisp object, use the IInkDisp::InkAdded and IInkDisp::InkDeleted events to listen for strokes that should be added or removed from the IInkRecognizerContext object. This covers cases where strokes are added to, deleted from, clipped, or split within the IInkDisp object.
Note
Moving, scaling, or other transformations on strokes in the IInkDisp object do not generate InkAdded or InkDeleted events. Perform the same transformations on the strokes in the IInkRecognizerContext object to keep the Strokes property synchronized.
Requirements
| Header | msinkaut.h |
| Windows Embedded CE | Windows CE 5.0 and later |
| Windows Mobile | Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later |