CompositeTransform CompositeTransform CompositeTransform Class

Applies multiple transform operations to an object.

Syntax

Declaration

public sealed class CompositeTransformpublic sealed class CompositeTransformPublic NotInheritable Class CompositeTransform
<CompositeTransform .../>

Inheritance Hierarchy

Inherited Members

Inherited methods

, , , , , , , , ,

Inherited properties

, ,

Windows.UI.Xaml.Media.GeneralTransform.TryTransform(Windows.Foundation.Point,Windows.Foundation.Point)
Windows.UI.Xaml.Media.GeneralTransform.TryTransform(Windows.Foundation.Point,Windows.Foundation.Point)
Windows.UI.Xaml.Media.GeneralTransform.TryTransform(Windows.Foundation.Point,Windows.Foundation.Point)
,
Windows.UI.Xaml.Media.GeneralTransform.TryTransformCore(Windows.Foundation.Point,Windows.Foundation.Point)
Windows.UI.Xaml.Media.GeneralTransform.TryTransformCore(Windows.Foundation.Point,Windows.Foundation.Point)
Windows.UI.Xaml.Media.GeneralTransform.TryTransformCore(Windows.Foundation.Point,Windows.Foundation.Point)

Remarks

CompositeTransform applies multiple transforms in this order:

  1. Scale (ScaleX, ScaleY )
  2. Skew (SkewX, SkewY )
  3. Rotate (Rotation )
  4. Translate (TranslateX, TranslateY )

If you want to apply multiple transforms to an object in a different order, you can create a TransformGroup and insert the transforms in your intended order.

CompositeTransform uses the same center point (CenterX, CenterY ) for all transformations. If you want to specify different center points per transform, use TransformGroup.

Examples

This example shows how to apply the same transforms to an object by using either a CompositeTransform or a TransformGroup.

<StackPanel Margin="50">
    <Canvas Background="Black" Width="200" Height="200">
        <Rectangle Height="100" Width="100" Fill="Red">
            <Rectangle.RenderTransform>

                <!-- This one line of markup is the equivalent of the entire
             TransformGroup block in the other Canvas below. -->
                <CompositeTransform SkewX="30" Rotation="45" ScaleX="0.8" ScaleY="0.8" />
            </Rectangle.RenderTransform>
        </Rectangle>
    </Canvas>

    <Canvas Margin="10" Background="Black" Width="200" Height="200">
        <Rectangle Height="100" Width="100" Fill="Red">
            <Rectangle.RenderTransform>
                <TransformGroup>

                    <!-- Note that you have to apply these transforms in 
                     a specific order to get the same effect as the
                     CompositeTransform. -->
                    <ScaleTransform ScaleX="0.8" ScaleY="0.8" />
                    <SkewTransform AngleX="30" />
                    <RotateTransform Angle="45" />
                </TransformGroup>
            </Rectangle.RenderTransform>
        </Rectangle>
    </Canvas>
</StackPanel>

Constructors summary

Initializes a new instance of the CompositeTransform class.

Properties summary

Gets or sets the x-coordinate of the center point for all transforms specified by the CompositeTransform in device-independent pixel (DIP) relative to the upper left-hand corner of the element.

Identifies the CenterX dependency property.

Gets or sets the y-coordinate of the center point for all transforms specified by the CompositeTransform in device-independent pixel (DIP) relative to the upper left-hand corner of the element.

Identifies the CenterY dependency property.

Gets or sets the angle, in degrees, of clockwise rotation.

Identifies the Rotation dependency property.

Gets or sets the x-axis scale factor. You can use this property to stretch or shrink an object horizontally.

Identifies the ScaleX dependency property.

Gets or sets the y-axis scale factor. You can use this property to stretch or shrink an object vertically.

Identifies the ScaleY dependency property.

Gets or sets the x-axis skew angle, which is measured in degrees counterclockwise from the y-axis. A skew transform can be useful for creating the illusion of three-dimensional depth in a two-dimensional object.

Identifies the SkewX dependency property.

Gets or sets the y-axis skew angle, which is measured in degrees counterclockwise from the x-axis. A skew transform can be useful for creating the illusion of three-dimensional depth in a two-dimensional object.

Identifies the SkewY dependency property.

Gets or sets the distance to translate along the x-axis.

Identifies the TranslateX dependency property.

Gets or sets the distance to translate (move) an object along the y-axis.

Identifies the TranslateY dependency property.

Constructors

  • CompositeTransform()
    CompositeTransform()
    CompositeTransform()
    CompositeTransform()

    Initializes a new instance of the CompositeTransform class.

    public CompositeTransform()public New()Public Sub New()public CompositeTransform()

Properties

  • CenterX
    CenterX
    CenterX
    CenterX

    Gets or sets the x-coordinate of the center point for all transforms specified by the CompositeTransform in device-independent pixel (DIP) relative to the upper left-hand corner of the element.

    public double CenterX { get; set; }public double CenterX { get; set; }Public ReadWrite Property CenterX As doublepublic double CenterX { get; set; }
    <CompositeTransform CenterX="double"/>
    

    Property Value

    • double
      double
      double

      The x-coordinate of the center point for all transforms specified by the CompositeTransform.

  • CenterXProperty
    CenterXProperty
    CenterXProperty
    CenterXProperty

    Identifies the CenterX dependency property.

    public static DependencyProperty CenterXProperty { get; }public static DependencyProperty CenterXProperty { get; }Public Static ReadOnly Property CenterXProperty As DependencyPropertypublic static DependencyProperty CenterXProperty { get; }

    Property Value

  • CenterY
    CenterY
    CenterY
    CenterY

    Gets or sets the y-coordinate of the center point for all transforms specified by the CompositeTransform in device-independent pixel (DIP) relative to the upper left-hand corner of the element.

    public double CenterY { get; set; }public double CenterY { get; set; }Public ReadWrite Property CenterY As doublepublic double CenterY { get; set; }
    <CompositeTransform CenterY="double"/>
    

    Property Value

    • double
      double
      double

      The y-coordinate of the center point for all transforms specified by the CompositeTransform.

  • CenterYProperty
    CenterYProperty
    CenterYProperty
    CenterYProperty

    Identifies the CenterY dependency property.

    public static DependencyProperty CenterYProperty { get; }public static DependencyProperty CenterYProperty { get; }Public Static ReadOnly Property CenterYProperty As DependencyPropertypublic static DependencyProperty CenterYProperty { get; }

    Property Value

  • Rotation
    Rotation
    Rotation
    Rotation

    Gets or sets the angle, in degrees, of clockwise rotation.

    public double Rotation { get; set; }public double Rotation { get; set; }Public ReadWrite Property Rotation As doublepublic double Rotation { get; set; }
    <CompositeTransform Rotation="double"/>
    

    Property Value

    • double
      double
      double

      The angle, in degrees, of clockwise rotation. The default is 0.

  • RotationProperty
    RotationProperty
    RotationProperty
    RotationProperty

    Identifies the Rotation dependency property.

    public static DependencyProperty RotationProperty { get; }public static DependencyProperty RotationProperty { get; }Public Static ReadOnly Property RotationProperty As DependencyPropertypublic static DependencyProperty RotationProperty { get; }

    Property Value

  • ScaleX
    ScaleX
    ScaleX
    ScaleX

    Gets or sets the x-axis scale factor. You can use this property to stretch or shrink an object horizontally.

    public double ScaleX { get; set; }public double ScaleX { get; set; }Public ReadWrite Property ScaleX As doublepublic double ScaleX { get; set; }
    <CompositeTransform ScaleX="double"/>
    

    Property Value

    • double
      double
      double

      The scale factor along the x-axis. The default is 1.

  • ScaleXProperty
    ScaleXProperty
    ScaleXProperty
    ScaleXProperty

    Identifies the ScaleX dependency property.

    public static DependencyProperty ScaleXProperty { get; }public static DependencyProperty ScaleXProperty { get; }Public Static ReadOnly Property ScaleXProperty As DependencyPropertypublic static DependencyProperty ScaleXProperty { get; }

    Property Value

  • ScaleY
    ScaleY
    ScaleY
    ScaleY

    Gets or sets the y-axis scale factor. You can use this property to stretch or shrink an object vertically.

    public double ScaleY { get; set; }public double ScaleY { get; set; }Public ReadWrite Property ScaleY As doublepublic double ScaleY { get; set; }
    <CompositeTransform ScaleY="double"/>
    

    Property Value

    • double
      double
      double

      The scale factor along the y-axis. The default is 1.

  • ScaleYProperty
    ScaleYProperty
    ScaleYProperty
    ScaleYProperty

    Identifies the ScaleY dependency property.

    public static DependencyProperty ScaleYProperty { get; }public static DependencyProperty ScaleYProperty { get; }Public Static ReadOnly Property ScaleYProperty As DependencyPropertypublic static DependencyProperty ScaleYProperty { get; }

    Property Value

  • SkewX
    SkewX
    SkewX
    SkewX

    Gets or sets the x-axis skew angle, which is measured in degrees counterclockwise from the y-axis. A skew transform can be useful for creating the illusion of three-dimensional depth in a two-dimensional object.

    public double SkewX { get; set; }public double SkewX { get; set; }Public ReadWrite Property SkewX As doublepublic double SkewX { get; set; }
    <CompositeTransform SkewX="double"/>
    

    Property Value

    • double
      double
      double

      The skew angle, which is measured in degrees counterclockwise from the y-axis. The default is 0.

  • SkewXProperty
    SkewXProperty
    SkewXProperty
    SkewXProperty

    Identifies the SkewX dependency property.

    public static DependencyProperty SkewXProperty { get; }public static DependencyProperty SkewXProperty { get; }Public Static ReadOnly Property SkewXProperty As DependencyPropertypublic static DependencyProperty SkewXProperty { get; }

    Property Value

  • SkewY
    SkewY
    SkewY
    SkewY

    Gets or sets the y-axis skew angle, which is measured in degrees counterclockwise from the x-axis. A skew transform can be useful for creating the illusion of three-dimensional depth in a two-dimensional object.

    public double SkewY { get; set; }public double SkewY { get; set; }Public ReadWrite Property SkewY As doublepublic double SkewY { get; set; }
    <CompositeTransform SkewY="double"/>
    

    Property Value

    • double
      double
      double

      The skew angle, which is measured in degrees counterclockwise from the x-axis. The default is 0.

  • SkewYProperty
    SkewYProperty
    SkewYProperty
    SkewYProperty

    Identifies the SkewY dependency property.

    public static DependencyProperty SkewYProperty { get; }public static DependencyProperty SkewYProperty { get; }Public Static ReadOnly Property SkewYProperty As DependencyPropertypublic static DependencyProperty SkewYProperty { get; }

    Property Value

  • TranslateX
    TranslateX
    TranslateX
    TranslateX

    Gets or sets the distance to translate along the x-axis.

    public double TranslateX { get; set; }public double TranslateX { get; set; }Public ReadWrite Property TranslateX As doublepublic double TranslateX { get; set; }
    <CompositeTransform TranslateX="double"/>
    

    Property Value

    • double
      double
      double

      The distance to translate (move) an object along the x-axis, in pixels. This property is read/write. The default is 0.

  • TranslateXProperty
    TranslateXProperty
    TranslateXProperty
    TranslateXProperty

    Identifies the TranslateX dependency property.

    public static DependencyProperty TranslateXProperty { get; }public static DependencyProperty TranslateXProperty { get; }Public Static ReadOnly Property TranslateXProperty As DependencyPropertypublic static DependencyProperty TranslateXProperty { get; }

    Property Value

  • TranslateY
    TranslateY
    TranslateY
    TranslateY

    Gets or sets the distance to translate (move) an object along the y-axis.

    public double TranslateY { get; set; }public double TranslateY { get; set; }Public ReadWrite Property TranslateY As doublepublic double TranslateY { get; set; }
    <CompositeTransform TranslateY="double"/>
    

    Property Value

    • double
      double
      double

      The distance to translate (move) an object along the y-axis, in pixels. The default is 0.

  • TranslateYProperty
    TranslateYProperty
    TranslateYProperty
    TranslateYProperty

    Identifies the TranslateY dependency property.

    public static DependencyProperty TranslateYProperty { get; }public static DependencyProperty TranslateYProperty { get; }Public Static ReadOnly Property TranslateYProperty As DependencyPropertypublic static DependencyProperty TranslateYProperty { get; }

    Property Value

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ActivatableAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.ThreadingAttribute
Windows.Foundation.Metadata.WebHostHiddenAttribute

Details

Assembly

Windows.UI.Xaml.Media.dll