IInkStrokes::Add
4/8/2010
Adds an IInkStrokeDisp object to an existing IInkStrokes collection.
Syntax
HRESULT Add (
[in] IInkStrokeDisp *stroke
);
Parameters
- stroke
Specifies the stroke to add to the IInkStrokes collection.
Return Value
| HRESULT value | Description |
|---|---|
S_OK |
Success. |
E_POINTER |
A parameter contained an invalid pointer. |
E_OUTOFMEMORY |
Cannot allocate IInkStrokeDisp handler helper object. |
E_INK_EXCEPTION |
An exception occurred inside the method. |
E_INK_INCOMPATIBLE_OBJECT |
IInkStrokeDisp* does not point to a compatible IInkStrokeDisp object. |
E_INK_MISMATCHED_INK_OBJECT |
The IInkDisp object of the IInkStrokeDisp being added does not match the IInkDisp object of the IInkStrokes collection. |
Remarks
Note
The stroke must already exist within the IInkDisp object, and cannot belong to another IInkDisp object. Also, this method does not copy or otherwise alter the IInkDisp object, but merely adds this stroke to the collection.
Use this method to add one stroke to an IInkStrokes collection. To add one collection of strokes to another, use the IInkStrokes::AddStrokes method.
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 |