TranslateTransform (Clase) (System.Windows.Media)

Cambiar vista:
Clásica
Ligera
Sin script
Biblioteca de clases de .NET Framework
TranslateTransform (Clase)
Este artículo se tradujo de forma manual. Para mostrar esta página y el contenido original en inglés al mismo tiempo, cambie a Lightweight según sus preferencias de visualización.

Traslada (mueve) un objeto en el sistema de coordenadas X-Y 2-D.

Jerarquía de herencia
System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        System.Windows.Media.Animation.Animatable
          System.Windows.Media.GeneralTransform
            System.Windows.Media.Transform
              System.Windows.Media.TranslateTransform

Espacio de nombres:  System.Windows.Media
Ensamblado:  PresentationCore (en PresentationCore.dll)
XMLNS para XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
Sintaxis
Visual Basic
Public NotInheritable Class TranslateTransform _
	Inherits Transform
C#
public sealed class TranslateTransform : Transform
Visual C++
public ref class TranslateTransform sealed : public Transform
F#
[<Sealed>]
type TranslateTransform =  
    class
        inherit Transform
    end
Uso de elementos de objeto XAML
<TranslateTransform .../>

El tipo TranslateTransform expone los siguientes miembros.

Constructores
  Nombre Descripción
Método público TranslateTransform() Inicializa una nueva instancia de la clase TranslateTransform.
Método público TranslateTransform(Double, Double) Inicializa una nueva instancia de la clase TranslateTransform y especifica los desplazamientos en la dirección de los ejes X e Y.
Arriba
Propiedades
  Nombre Descripción
Propiedad pública CanFreeze Obtiene un valor que indica si el objeto se puede convertir en no modificable. (Se hereda de Freezable).
Propiedad pública DependencyObjectType Obtiene el objeto DependencyObjectType que ajusta el tipo CLR de esta instancia.  (Se hereda de DependencyObject).
Propiedad pública Dispatcher Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Se hereda de DispatcherObject).
Propiedad pública HasAnimatedProperties Obtiene un valor que indica si uno o más objetos AnimationClock se asocian a cualquiera de las propiedades de dependencia de este objeto. (Se hereda de Animatable).
Propiedad pública Inverse Obtiene la transformación inversa de esta transformación, si existe. (Se hereda de Transform).
Propiedad pública IsFrozen Obtiene un valor que indica si el objeto es modificable actualmente. (Se hereda de Freezable).
Propiedad pública IsSealed Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Se hereda de DependencyObject).
Propiedad pública Value Obtiene una representación en forma de Matrix de este objeto TranslateTransform. (Invalida a Transform.Value).
Propiedad pública X Obtiene o establece la distancia de la traslación a lo largo del eje X.
Propiedad pública Y Obtiene o establece la distancia de la traslación (movimiento) de un objeto a lo largo del eje Y.
Arriba
Métodos
  Nombre Descripción
Método público ApplyAnimationClock(DependencyProperty, AnimationClock) Aplica un objeto AnimationClock al objeto DependencyProperty especificado. Si la propiedad ya está animada, se usa el comportamiento de entrega de SnapshotAndReplace. (Se hereda de Animatable).
Método público ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) Aplica un objeto AnimationClock al objeto DependencyProperty especificado. Si la propiedad ya está animada, se usa el objeto HandoffBehavior especificado. (Se hereda de Animatable).
Método público BeginAnimation(DependencyProperty, AnimationTimeline) Aplica una animación al objeto DependencyProperty especificado. La animación empieza cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el comportamiento de entrega de SnapshotAndReplace. (Se hereda de Animatable).
Método público BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) Aplica una animación al objeto DependencyProperty especificado. La animación empieza cuando se representa el siguiente fotograma. Si la propiedad especificada ya está animada, se usa el objeto HandoffBehavior especificado. (Se hereda de Animatable).
Método público CheckAccess Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Se hereda de DispatcherObject).
Método público ClearValue(DependencyProperty) Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador de DependencyProperty. (Se hereda de DependencyObject).
Método público ClearValue(DependencyPropertyKey) Borra el valor local de una propiedad de sólo lectura. DependencyPropertyKey especifica la propiedad que se va a borrar. (Se hereda de DependencyObject).
Método público Clone Crea una copia modificable de este objeto TranslateTransform y hace copias en profundidad de sus valores.
Método protegido CloneCore Convierte la instancia en un clon (copia en profundidad) de la clase Freezable especificada con los valores de la propiedad base (no animada). (Se hereda de Freezable).
Método público CloneCurrentValue Crea una copia modificable de este objeto TranslateTransform y hace copias en profundidad de sus valores. Este método no copia referencias de recursos, enlaces de datos ni animaciones, pero sí copia sus valores actuales.
Método protegido CloneCurrentValueCore Convierte la instancia en un clon modificable (en profundidad) del objeto Freezable especificado utilizando los valores de las propiedades actuales. (Se hereda de Freezable).
Método público CoerceValue Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función de CoerceValueCallback especificada en los metadatos de la propiedad de dependencia cuando existe en el objeto DependencyObject de llamada. (Se hereda de DependencyObject).
Método protegido CreateInstance Inicializa una nueva instancia de la clase Freezable. (Se hereda de Freezable).
Método protegido CreateInstanceCore Cuando se implementa en una clase derivada, crea una nueva instancia de la clase Freezable derivada. (Se hereda de Freezable).
Método público Equals Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Se hereda de DependencyObject).
Método protegido Finalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método público Freeze() Convierte el objeto actual en no modificable y establece su propiedad IsFrozen en true. (Se hereda de Freezable).
Método protegido FreezeCore Convierte este objeto Animatable en no modificable o determina si se puede convertir en no modificable. (Se hereda de Animatable).
Método público GetAnimationBaseValue Devuelve el valor no animado del objeto DependencyProperty especificado. (Se hereda de Animatable).
Método público GetAsFrozen Crea una copia inmovilizada de Freezable, con los valores de la propiedad base (no animada). Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Se hereda de Freezable).
Método protegido GetAsFrozenCore Convierte la instancia en un clon inmovilizado de la clase Freezable especificada con los valores de la propiedad base (no animada). (Se hereda de Freezable).
Método público GetCurrentValueAsFrozen Crea una copia inmovilizada de Freezable con los valores de propiedad actuales. Puesto que se inmoviliza la copia, se copia cualquier subobjeto inmovilizado por referencia. (Se hereda de Freezable).
Método protegido GetCurrentValueAsFrozenCore Convierte la instancia actual en un clon inmovilizado de la clase Freezable especificada. Si el objeto tiene propiedades de dependencia animadas, se copian sus valores animados actuales. (Se hereda de Freezable).
Método público GetHashCode Obtiene un código hash de este objeto DependencyObject. (Se hereda de DependencyObject).
Método público GetLocalValueEnumerator Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Se hereda de DependencyObject).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público GetValue Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de DependencyObject. (Se hereda de DependencyObject).
Método público InvalidateProperty Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Se hereda de DependencyObject).
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegido OnChanged Se llama cuando se modifica el objeto Freezable actual. (Se hereda de Freezable).
Método protegido OnFreezablePropertyChanged(DependencyObject, DependencyObject) Se asegura de que se establecen los punteros contextuales adecuados para un miembro de datos DependencyObjectType que se acaba de establecer. (Se hereda de Freezable).
Método protegido OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) Este miembro admite la infraestructura de Windows Presentation Foundation (WPF) y no se debe usar directamente desde el código. (Se hereda de Freezable).
Método protegido OnPropertyChanged Invalida la implementación de DependencyObject de OnPropertyChanged para invocar también cualquier controlador Changed como respuesta a un cambio de propiedad de dependencia de tipo Freezable. (Se hereda de Freezable).
Método público ReadLocalValue Devuelve el valor local de una propiedad de dependencia, si existe. (Se hereda de DependencyObject).
Método protegido ReadPreamble Se asegura de que se tiene acceso a Freezable desde un subproceso válido. Los herederos de Freezable deben llamar a este método al inicio de las API que lean miembros de datos que no son propiedades de dependencia. (Se hereda de Freezable).
Método público SetCurrentValue Establece el valor de una propiedad de dependencia sin cambiar el origen de su valor. (Se hereda de DependencyObject).
Método público SetValue(DependencyProperty, Object) Establece el valor local de una propiedad de dependencia, especificado por su identificador de propiedad de dependencia. (Se hereda de DependencyObject).
Método público SetValue(DependencyPropertyKey, Object) Establece el valor local de una propiedad de dependencia de sólo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Se hereda de DependencyObject).
Método protegido ShouldSerializeProperty Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia proporcionada. (Se hereda de DependencyObject).
Método público ToString() Crea una representación de cadena de este objeto GeneralTransform. (Se hereda de GeneralTransform).
Método público ToString(IFormatProvider) Crea una representación de cadena de esta instancia, basándose en el parámetro IFormatProvider pasado. (Se hereda de GeneralTransform).
Método público Transform Transforma el punto especificado y devuelve el resultado. (Se hereda de GeneralTransform).
Método público TransformBounds Transforma el rectángulo de selección especificado y devuelve un rectángulo de selección alineado con el eje que es suficientemente grande como para contener la estructura. (Se hereda de Transform).
Método público TryTransform Intenta transformar el punto especificado y devuelve un valor que indica si la transformación se realizó correctamente. (Se hereda de Transform).
Método público VerifyAccess Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Se hereda de DispatcherObject).
Método protegido WritePostscript Provoca el evento Changed de Freezable e invoca su método OnChanged. Las clases que se derivan de Freezable deben llamar a este método al final de cualquier API que modifique miembros de clase que no se almacenen como propiedades de dependencia. (Se hereda de Freezable).
Método protegido WritePreamble Comprueba que no se inmovilice Freezable y que se tiene acceso desde un contexto de subproceso válido. Los herederos de Freezable deben llamar a este método al inicio de cualquier API que escriba en miembros de datos que no sean propiedades de dependencia. (Se hereda de Freezable).
Arriba
Eventos
  Nombre Descripción
Evento público Changed Se produce cuando se modifican la clase Freezable o un objeto que la contiene. (Se hereda de Freezable).
Arriba
Campos
  Nombre Descripción
Campo público Miembro estático XProperty Identifica la propiedad de dependencia X.
Campo público Miembro estático YProperty Identifica la propiedad de dependencia Y.
Arriba
Implementaciones explícitas de interfaces
  Nombre Descripción
Implementación explícita de interfaces Método privado IFormattable.ToString Aplica formato al valor de la instancia actual utilizando el formato especificado. (Se hereda de GeneralTransform).
Arriba
Comentarios

TranslateTransform define una traslación alineada con el eje a lo largo de los ejes X e Y. En la ilustración siguiente se muestra la matriz de transformación para una traslación por desplazamiento (dx, dy).

Matriz de 3x3 típica para las traslaciones 2D

Matriz de traslación 100010dxdy1

Características de elementos Freezable: Como hereda de la clase Freezable, la clase TranslateTransform proporciona varias características especiales: los objetos TranslateTransform se pueden declarar como recursos, se pueden compartir entre varios objetos, se puede hacer que sean de sólo lectura para mejorar el rendimiento, se pueden clonar y se pueden hacer seguros para subprocesos. Para obtener más información acerca de las diferentes características que proporcionan los objetos Freezable, consulte Información general sobre objetos Freezable.

Ejemplos

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.

XAML

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

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

Información de versión

.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1
Plataformas

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Seguridad para subprocesos
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Vea también

Referencia

System.Windows.Media (Espacio de nombres)
Matrix

Otros recursos

Información general sobre transformaciones
Temas "Cómo..." de transformaciones
Información general sobre objetos Freezable
Información general sobre animaciones
2-D Transforms Sample