IInkRenderer::SetViewTransform method (msinkaut.h)

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

Syntax

HRESULT SetViewTransform(
  [in] IInkTransform *ViewTransform
);

Parameters

[in] ViewTransform

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

Remarks

The transformation applies to both the points and pen width.

View transformation occurs after object transformation.

The pen width is calculated by multiplying the specified pen width (or default of 53, if unspecified) by the square root of the determinant of the view transform.

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