IInkRenderer::SetObjectTransform method (msinkaut.h)

Sets the InkTransform object that represents the object transform that is used to render ink.

Syntax

HRESULT SetObjectTransform(
  [in] IInkTransform *ObjectTransform
);

Parameters

[in] ObjectTransform

The InkTransform object that represents the geometric transformation - rotation, scaling, shear, and reflection - values to use to transform the stroke coordinates within the ink space.

A NULL value for the objectTransform parameter correlates to the identity transform.

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
objectTransform does not point to a compatible InkTransform object.
E_INK_EXCEPTION
An exception occurred inside the method.

Remarks

The transformation applies to the points, but not the pen width.

Object transformation occurs before view transformation.

It is problematic to call this method in response to SENT message. Test whether you are processing a SENT message by calling InSendMesssageEx and then POST the message to yourself if the message was SENT.

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

GetObjectTransform Method

GetViewTransform Method

IInkRenderer

InkRenderer Class

SetViewTransform Method