TranslateTransform, classe
Réduire la table des matières
Développer la table des matières

TranslateTransform, classe

Translates (moves) an object in the 2-D x-y coordinate system.

Espace de noms: System.Windows.Media
Assembly : PresentationCore (dans presentationcore.dll)
Espace de noms XML :

public sealed class TranslateTransform : Transform
public final class TranslateTransform extends Transform
public final class TranslateTransform extends Transform

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).

Typical 3x3 matrix for 2-D translations

Freezable Features: Because it inherits from the Freezable class, the TranslateTransform class provides several special features: TranslateTransform objects can be declared as resources, shared among multiple objects, made read-only to improve performance, cloned, and made thread-safe. For more information about the different features provided by Freezable objects, see Freezable Objects Overview.

This example shows how to translate (move) an element by using a TranslateTransform.

The TranslateTransform class is especially useful for moving elements inside panels that do not support absolute positioning. For example, by applying a TranslateTransform to the RenderTransform property of an element, you can move an element within a StackPanel or DockPanel.

Use the X property of the TranslateTransform to specify the amount, in pixels, to move the element along the x-axis. Use the Y property to specify the amount, in pixels, to move the element along the y-axis. Finally, apply the TranslateTransform to the RenderTransform property of the element.

The following example uses a TranslateTransform to move an element 50 pixels to the right and 50 pixels down.

<Rectangle Height="50" Width="50" 
  Fill="#CCCCCCFF" Stroke="Blue" StrokeThickness="2"
  Canvas.Left="100" Canvas.Top="100">
    <TranslateTransform X="50" Y="50" />

For the complete sample, see 2-D Transforms Sample.


Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0

Ajouts de la communauté

© 2016 Microsoft