Share via


IXRTransformGroup (Compact 2013)

3/28/2014

This class represents a composite transformation object that is composed of other objects derived from IXRTransform.

Syntax

class IXRTransformGroup : public IXRTransform

Inheritance Hierarchy

IXRDependencyObject

    IXRGeneralTransform

        IXRTransform

            IXRTransformGroup

Methods

Method

Description

IXRTransformGroup::GetChildren

Retrieves the collection of child objects derived from IXRTransform.

IXRTransformGroup::GetValue

Retrieves the IXRMatrix structure calculated by XAML for Windows Embedded that describes the transformationIXRTransformGroup.

IXRTransformGroup::SetChildren

Sets the collection of child objects derived from IXRTransform.

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

When you want to apply multiple transformation operations to a single object, use an IXRTransformGroup object, which contains an IXRTransformCollection collection of child objects.

In a composite transformation, the order of individual transformations is important. For example, if you first rotate, then scale, then translate, the result is different than if you first translate, then rotate, then scale. Order is significant because transformations such as rotation and scaling are performed with respect to the origin of the coordinate system. Scaling or rotating an object that is centered at the origin produces a different result than scaling or rotating an object that is moved away from the origin.

To define the order in which transformations are applied, you can use the IXRTransformCollection::Insert method to define an index for adding objects to the IXRTransformCollection. Or you can add each IXRTransform object to the collection in the order in which they should be applied by using the IXRTransformCollection::Add method.

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

You can also define a composite transformation in Microsoft Silverlight 3 XAML. For information about the differences between XAML in XAML for Windows Embedded and Silverlight 3, see Differences Between Microsoft Silverlight 3 and XAML for Windows Embedded. For more information about how to define this element in the source XAML for your application, see the TransformGroup Class on MSDN.

.NET Framework Equivalent

System.Windows.Media.TransformGroup

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

Classes for Visual Appearance