This topic has not yet been rated - Rate this topic

InkStrokes.Add method

Applies to: desktop apps only

Adds an IInkStrokeDisp object or InkStrokes collection to an existing InkStrokes collection.

Syntax

HRESULT Add(
  [in]  IInkStrokeDisp *InkStroke
);

Parameters

InkStroke [in]: The stroke to add to the InkStrokes collection.

Return value

This method can return one of these values.

Return code	Description
S_OK	Success.
E_POINTER	A parameter contained an invalid pointer.
E_OUTOFMEMORY	Cannot allocate Stroke 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 InkDisp object of the IInkStrokeDisp being added does not match the InkDisp object of the InkStrokes collection.

Remarks

Note The stroke must already exist within the InkDisp object, and cannot belong to another InkDisp object. Also, this method does not copy or otherwise alter the InkDisp object, but merely adds this stroke to the collection.

Use this method to add one stroke to an InkStrokes collection. To add one collection of strokes to another, use the AddStrokes method.

Requirements

Minimum supported client	Windows XP Tablet PC Edition
Minimum supported server	None supported
Header	Msinkaut.h (also requires Msinkaut_i.c)
Library	InkObj.dll

Community Additions

ADD