Cette documentation est archivée et n’est pas conservée.

TranslateTransform, classe

Mise à jour : novembre 2007

Traduit (déplace) un objet dans le système de coordonnées protégé en écriture de 2D.

Espace de noms :  System.Windows.Media
Assembly :  PresentationCore (dans PresentationCore.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/xaml/presentation

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

TranslateTransform définit une traduction alignée par axe le long des axes x - et y -. L'illustration suivante affiche la matrice de transformation pour une traduction par offset (dx, dy).

Matrice 3x3 typique pour les traductions 2 D

Matrice de traduction 100010dxdy1

Fonctionnalités Freezable : dans la mesure où elle hérite de la classe Freezable, la classe TranslateTransform propose plusieurs fonctionnalités spéciales : les objets TranslateTransform peuvent être déclarés en tant que ressources, partagés entre plusieurs objets, définis en lecture seule pour améliorer les performances, clonés et thread-safe. Pour plus d'informations sur les différentes fonctionnalités fournies par les objets Freezable, consultez Vue d'ensemble des objets Freezable.

Cet exemple montre comment traduire (déplacer) un élément en utilisant un TranslateTransform.

La classe TranslateTransform est particulièrement utile pour déplacer des éléments à l'intérieur des panneaux qui ne prennent pas en charge le positionnement absolu. Par exemple, vous pouvez déplacer un élément dans un StackPanel ou un DockPanel en appliquant un TranslateTransform à la propriété RenderTransform d'un élément.

Utilisez la propriété X du TranslateTransform pour spécifier la quantité, en pixels, pour déplacer l'élément le long de l'axe x. Utilisez la propriété Y pour spécifier la quantité, en pixels, pour déplacer l'élément le long de l'axe y. Enfin, appliquez le TranslateTransform à la propriété RenderTransform de l'élément.

L'exemple suivant utilise un TranslateTransform pour déplacer un élément de 50 pixels vers la droite et de 50 pixels vers le bas.

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


Pour l'exemple complet, consultez Transformations 2D, exemple.

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

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0
Afficher: