IInkStrokes::Transform method (msinkaut.h)

Applies a linear transformation to an IInkStrokeDisp object or an InkStrokes collection, which can represent scaling, rotation, translation, and combinations of transformations.

Syntax

HRESULT Transform(
  [in]           IInkTransform *Transform,
  [in, optional] VARIANT_BOOL  ApplyOnPenWidth
);

Parameters

[in] Transform

The transform to use on the stroke or strokes. (This is an InkTransform object, which correlates to the XFORM structure). The transformation applies to both the points and pen width (if ApplyOnPenWidth is VARIANT_TRUE).

[in, optional] ApplyOnPenWidth

Optional. VARIANT_TRUE to apply the transform to the width of the ink in the InkDrawingAttributes of the strokes; otherwise, VARIANT_FALSE. The default is VARIANT_FALSE.

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_INVALIDARG
Invalid argument.
E_UNEXPECTED
Unexpected parameter or property type.
E_INK_EXCEPTION
An exception occurred inside the method.

Requirements

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

See also

IInkStrokes

InkStrokes Collection