This topic has not yet been rated - Rate this topic

InkRenderer.SetObjectTransform method

Applies to: desktop apps only

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

Syntax

HRESULT SetObjectTransform(
  [in]  IInkTransform *ObjectTransform
);

Parameters

ObjectTransform [in]

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 codeDescription
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

Minimum supported client

Windows XP Tablet PC Edition

Minimum supported server

None supported

Header

Msinkaut.h (also requires Msinkaut_i.c)

Library

InkObj.dll

See also

InkRenderer Class
GetObjectTransform Method
GetViewTransform Method
SetViewTransform Method

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ