See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Gets or sets the IInkStrokescollection associated with the IInkRecognizerContextobject.
Syntax
[propputref] HRESULT putref_Strokes ([in] IInkStrokes *Strokes); [propget] HRESULT get_Strokes ([out, retval] IInkStrokes **Strokes ); |
Parameters
- Strokes
-
The IInkStrokescollection associated with the IInkRecognizerContextobject.
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 IInkStrokescollection more than once. Each time you set the IInkStrokescollection, the IInkRecognizerContextobject is reset—any ink or results are removed—and then the new strokes are added.
The IInkStrokescollection can also be set to NULL, which also resets the IInkRecognizerContextobject. When the IInkRecognizerContextis reset, it keeps any guides, factoids, and other properties which previously had been set on it.
To keep the Strokesproperty synchronized with an IInkDispobject, use the IInkDisp::InkAddedand IInkDisp::InkDeletedevents to listen for strokes that should be added or removed from the IInkRecognizerContextobject. This covers cases where strokes are added to, deleted from, clipped, or split within the IInkDispobject.
 Note: |
|---|
| Moving, scaling, or other transformations on strokes in the IInkDispobject do not generate InkAddedor InkDeletedevents. Perform the same transformations on the strokes in the IInkRecognizerContextobject to keep the Strokesproperty 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 |