IInkRenderer::SetObjectTransform method (msinkaut.h)

Article
02/22/2024

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