Share via


IXRTransform (Compact 2013)

3/28/2014

This class defines transformations in a two-dimensional plane on the graphical window.

Syntax

class IXRTransform : public IXRInternalTransform

Inheritance Hierarchy

IXRDependencyObject

    IXRGeneralTransform

        IXRTransform

            IXRCompositeTransform

            IXRMatrixTransform

            IXRRotateTransform

            IXRScaleTransform

            IXRSkewTransform

            IXRTransformGroup

            IXRTranslateTransform

Methods

This class provides no new methods. It inherits its methods from IXRGeneralTransform.

Thread Safety

Members of this class are thread safe if you previously called IXRApplication::CreateHostFromXaml and supplied it with an XRWindowCreateParams structure that has AllowsMultipleThreadAccess set to true.

Remarks

Transformations define a visual effect for an object such as rotation, scaling, skewing, and positioning translation. When you use a transformation you do not have to modify an IXRMatrix directly. Unlike IXRMatrix, IXRTransform supports animation and enumeration semantics.

IXRTransform inherits from the IXRInternalTransform interface, which, in turn, inherits from the IXRGeneralTransform interface.

For XAML for Windows Embedded methods that retrieve or set an IXRTransform object, you must specify a derived class. Typically, this is one of the following classes: IXRMatrixTransform, IXRRotateTransform, IXRScaleTransform, IXRSkewTransform, IXRTransformGroup, and IXRTranslateTransform.

When you create an object derived from IXRTransform and associate it with a UI object derived from classes such as IXRBrush, IXRGeometry, or IXRUIElement, you can change its properties during run time by calling its methods inside an event handler.

You can use the IXRMatrixTransform class to create custom transformations that are not provided by the other derived classes.

A two-dimensional x,y plane on a graphical window uses a matrix with 3 × 3 dimensions. You can multiply affine transformation matrices to form linear transformations, such as rotation and skew transformations, that are followed by positioning translation.

The final column of an affine transformation matrix is equal to (0, 0, 1). Therefore, you only have to specify the members in the first two columns.

You cannot extract the matrix-specific information from non-matrix transformations.

If you create a class instance, use an IXRTransformPtr smart pointer instead of a raw interface pointer. For more information, see XRPtr<Interface>.

.NET Framework Equivalent

System.Windows.Media.Transform

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

Classes for Visual Appearance