IInkDisp::AddStrokesAtRectangle method (msinkaut.h)

Adds a specified Strokes collection into this InkDisp object at a specified rectangle.

Syntax

HRESULT AddStrokesAtRectangle(
  [in] IInkStrokes   *SourceStrokes,
  [in] IInkRectangle *TargetRectangle
);

[in] SourceStrokes

The strokes to add to the ink. These source strokes are appended to this InkDisp object.

[in] TargetRectangle

The InkRectangle in ink space coordinates where the strokes are added. A run-time error occurs if the coordinates of the rectangle are {0,0,0,0}.

This method can return one of these values.

Return code	Description
S_OK	Success.
E_POINTER	A parameter contained an invalid pointer.
E_FAIL	An unspecified error occurred.
E_INK_INCOMPATIBLE_OBJECT	A pointer does not point at a valid object.
E_INK_EXCEPTION	An exception occurred inside the method.
E_INVALIDARG	The rectangle's top and bottom are equal.

When inserted, the strokes are scaled from the bounding box of the strokes to the rectangle.

This method can be used to copy strokes within a single InkDisp object. The source ink strokes do not have to come from another InkDisp object.

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