Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

Alters the IInkTransformto shear the ink in the stroke or strokes by the specified horizontal and vertical factors.

Syntax

HRESULT Shear (
  float shearX,
  float shearY
);

Parameters

shearX

[in] The horizontal factor of the shear.

shearY

[in] The vertical factor of the shear.

Return Value

HRESULT value Description

S_OK

Success.

E_INK_EXCEPTION

An exception occurred inside the method.

Remarks

The transformation applied in this method is a pure shear only if one of the parameters is 0. Applied to a rectangle at the origin, when the shearYfactor is 0, the transformation moves the bottom edge horizontally by shearXtimes the height of the rectangle. When the shearXfactor is 0, it moves the right edge vertically by shearYtimes the width of the rectangle.

Note:
When both parameters are nonzero, the results may not be intuitive.

This method throws an exception if the shear is non-invertible. The shear is non-invertible if the product of the shearXand shearYparameters equals 1.

Requirements

Header msinkaut.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later

See Also