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
IXRTransform
IXRTransformGroup
Methods
Method |
Description |
|---|---|
Retrieves the collection of child objects derived from IXRTransform. |
|
Retrieves the IXRMatrix structure calculated by XAML for Windows Embedded that describes the transformationIXRTransformGroup. |
|
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 |