MatrixTransform.Matrix Property

Gets or sets the Matrix structure that defines this transformation. This is a dependency property.

Namespace: System.Windows.Media
Assembly: PresentationCore (in presentationcore.dll)
XML Namespace:  http://schemas.microsoft.com/winfx/2006/xaml/presentation

public Matrix Matrix { get; set; }
/** @property */
public Matrix get_Matrix ()

/** @property */
public void set_Matrix (Matrix value)

public function get Matrix () : Matrix

public function set Matrix (value : Matrix)

<object>
  <object.Matrix>
    <Matrix .../>
  </object.Matrix>
</object>
<object Matrix="Matrix" .../>

Property Value

The Matrix structure that defines this transformation. The default value is an identity Matrix. An identity matrix has a value of 1 in coefficients [1,1], [2,2], and [3,3]; and a value of 0 in the rest of the coefficients.

Identifier Field

MatrixProperty

Metadata Flags

None

This example shows how to use a MatrixTransform to translate (move) the position, stretch, and skew of a Button.

NoteNote:

Use the MatrixTransform class to create custom transformations that are not provided by the RotateTransform, SkewTransform, ScaleTransform, or TranslateTransform classes.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
  <StackPanel Margin="20">
    <Canvas HorizontalAlignment="Left" Width="340" Height="240" >

      <Button MinWidth="100">Click
        <Button.RenderTransform>
          <MatrixTransform x:Name="myMatrixTransform">
            <MatrixTransform.Matrix >
              
              <!-- OffsetX and OffsetY specify the position of the button,
              M11 stretches it, and M12 skews it. -->
              <Matrix OffsetX="10" OffsetY="100" M11="3" M12="2"/>
            </MatrixTransform.Matrix>
          </MatrixTransform>
        </Button.RenderTransform>
      </Button>
    </Canvas>
  </StackPanel>
</Page>

More Code

How to: Animate a Matrix by Using Key Frames

This example shows how to animate the Matrix property of a MatrixTransform by using key frames.

How to: Animate an Object Along a Path (Matrix Animation)

This example shows how to use the MatrixAnimationUsingPath class to animate an object along a path that is defined by a PathGeometry.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions

ADD
Show: