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
);

Parameters

[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}.

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_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.

Remarks

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.

Requirements

   
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

See also

IInkDisp

InkDisp Class

InkStrokes Collection