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