IInkDisp::AddStrokesAtRectangle

4/8/2010

Adds a specified IInkStrokes collection into this IInkDisp object at a specified rectangle.

Syntax

HRESULT AddStrokesAtRectangle (
  IInkStrokes* strokes,
  IInkRectangle* rectangle
);

Parameters

• strokes
  [in] Specifies the strokes to add to the ink. These source strokes are appended to this IInkDisp object.

• rectangle
  [in] Specifies the IInkRectangle 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

• 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 IInkDisp object. The source ink strokes do not have to come from another IInkDisp object.

Requirements

See Also

Concepts

Windows Mobile Ink Reference