TranslateTransform Class
Translates (moves) an object in the two-dimensional x-y coordinate system.
System.Windows.DependencyObject
System.Windows.Media.GeneralTransform
System.Windows.Media.Transform
System.Windows.Media.TranslateTransform
Namespace: System.Windows.Media
Assembly: System.Windows (in System.Windows.dll)
The TranslateTransform type exposes the following members.
| Name | Description | |
|---|---|---|
![]() ![]() | Dispatcher | Gets the Dispatcher this object is associated with. (Inherited from DependencyObject.) |
![]() ![]() | Inverse | Gets the inverse of this transform, if it exists. (Inherited from Transform.) |
![]() ![]() | X | Gets or sets the distance to translate along the x-axis. |
![]() ![]() | Y | Gets or sets the distance to translate (move) an object along the y-axis. |
| Name | Description | |
|---|---|---|
![]() ![]() | CheckAccess | Determines whether the calling thread has access to this object. (Inherited from DependencyObject.) |
![]() ![]() | ClearValue | Clears the local value of a dependency property. (Inherited from DependencyObject.) |
![]() ![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() ![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
![]() ![]() | GetAnimationBaseValue | Returns any base value established for a Silverlight dependency property, which would apply in cases where an animation is not active. (Inherited from DependencyObject.) |
![]() ![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() ![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() ![]() | GetValue | Returns the current effective value of a dependency property from a DependencyObject. (Inherited from DependencyObject.) |
![]() ![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() ![]() | ReadLocalValue | Returns the local value of a dependency property, if a local value is set. (Inherited from DependencyObject.) |
![]() ![]() | SetValue | Sets the local value of a dependency property on a DependencyObject. (Inherited from DependencyObject.) |
![]() ![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
![]() ![]() | Transform | Transforms the specified point and returns the result. (Inherited from GeneralTransform.) |
![]() ![]() | TransformBounds | Transforms the specified bounding box and returns an axis-aligned bounding box that is exactly large enough to contain it. (Inherited from Transform.) |
![]() ![]() | TryTransform | Attempts to transform the specified point and returns a value that indicates whether the transformation was successful. (Inherited from Transform.) |
The local 0,0 for an object can be offset on a Canvas using Canvas.Left and Canvas.Top, but this does not count as a transform; the object retains its own local 0,0 in this case for transform purposes.
Multiple transforms can be applied with a TransformGroup. Custom transforms can be created with a MatrixTransform.
TranslateTransform defines an axis-aligned translation along the x and y axes. The following illustration shows the transformation matrix for a translation by offset (dx, dy).

Transforms can alter the display of text in your application to create a decorative effect. The following illustration shows text translated, or moved, along the x and y axes.

The following example uses a TranslateTransform to offset text. In this example, a slightly offset copy of text below the primary text creates a shadow effect.
<Canvas> <!-- Offset the text using a TranslateTransform. --> <TextBlock FontFamily="Verdana" FontSize="32" FontWeight="Bold" Foreground="Black" Text="Translated Text"> <TextBlock.RenderTransform> <TranslateTransform X="2" Y="2" /> </TextBlock.RenderTransform> </TextBlock> <TextBlock FontFamily="Verdana" FontSize="32" FontWeight="Bold" Foreground="Coral" Text="Translated Text"/> </Canvas>
The example below shows how to increase the X and Y property values of a TranslateTransform applied to a Rectangle every time the Rectangle is clicked.
<Canvas xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Width="200" Height="200"> <Rectangle MouseLeftButtonDown="handleMouseButtonDown" Width="50" Height="50" Fill="RoyalBlue"> <Rectangle.RenderTransform> <!-- If you give the transform a name you can access it easily from code. --> <TranslateTransform x:Name="myTranslateTransform" /> </Rectangle.RenderTransform> </Rectangle> </Canvas>
private void handleMouseButtonDown(object sender, EventArgs e) { // Increase the X and Y properties. myTranslateTransform.X = myTranslateTransform.X + 15; myTranslateTransform.Y = myTranslateTransform.Y + 15; }
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.





