TranslateTransform TranslateTransform TranslateTransform Class

Definition

Translates (moves) an object in the two-dimensional x-y coordinate system.

public : sealed class TranslateTransform : Transform, ITranslateTransform
public sealed class TranslateTransform : Transform, ITranslateTransform
Public NotInheritable Class TranslateTransform Inherits Transform Implements ITranslateTransform
<TranslateTransform .../>
Inheritance
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Examples

This 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>
<Canvas Width="200" Height="200">
    <Rectangle PointerPressed="Rectangle_PointerPressed" 
               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 Rectangle_PointerPressed(object sender, Windows.UI.Xaml.Input.PointerRoutedEventArgs e)
{
    // Increase the X and Y properties.
    myTranslateTransform.X = myTranslateTransform.X + 15;
    myTranslateTransform.Y = myTranslateTransform.Y + 15;
}

Constructors

TranslateTransform() TranslateTransform() TranslateTransform()

Initializes a new instance of the TranslateTransform class.

public : TranslateTransform()
public TranslateTransform()
Public Sub New()

Properties

Dispatcher Dispatcher Dispatcher

Gets the CoreDispatcher that this object is associated with. The CoreDispatcher represents a facility that can access the DependencyObject on the UI thread even if the code is initiated by a non-UI thread.

(Inherited from DependencyObject)

Inverse Inverse Inverse

Gets the inverse transformation of this GeneralTransform, if possible.

(Inherited from GeneralTransform)

InverseCore InverseCore InverseCore

Implements the behavior for return value of Inverse in a derived or custom GeneralTransform.

(Inherited from GeneralTransform)

X X X

Gets or sets the distance to translate along the x-axis.

public : double X { get; set; }
public double X { get; set; }
Public ReadWrite Property X As double
<TranslateTransform X="double"/>
Value
double double double

The distance to translate (move) an object along the x-axis, in pixels. This property is read/write. The default is 0.

XProperty XProperty XProperty

Identifies the X dependency property.

public : static DependencyProperty XProperty { get; }
public static DependencyProperty XProperty { get; }
Public Static ReadOnly Property XProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the X dependency property.

Y Y Y

Gets or sets the distance to translate (move) an object along the y-axis.

public : double Y { get; set; }
public double Y { get; set; }
Public ReadWrite Property Y As double
<TranslateTransform Y="double"/>
Value
double double double

The distance to translate (move) an object along the y-axis, in pixels. The default is 0.

YProperty YProperty YProperty

Identifies the Y dependency property.

public : static DependencyProperty YProperty { get; }
public static DependencyProperty YProperty { get; }
Public Static ReadOnly Property YProperty As DependencyProperty
Value
DependencyProperty DependencyProperty DependencyProperty

The identifier for the Y dependency property.

Methods

ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Clears the local value of a dependency property.

(Inherited from DependencyObject)

GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty)

Returns any base value established for a dependency property, which would apply in cases where an animation is not active.

(Inherited from DependencyObject)

GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Returns the current effective value of a dependency property from a DependencyObject.

(Inherited from DependencyObject)

ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Returns the local value of a dependency property, if a local value is set.

(Inherited from DependencyObject)

RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback)

Registers a notification function for listening to changes to a specific DependencyProperty on this DependencyObject instance.

(Inherited from DependencyObject)

SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object)

Sets the local value of a dependency property on a DependencyObject.

(Inherited from DependencyObject)

TransformBounds(Rect) TransformBounds(Rect) TransformBounds(Rect)

Transforms the specified bounding box and returns an axis-aligned bounding box that is exactly large enough to contain it.

(Inherited from GeneralTransform)

TransformBoundsCore(Rect) TransformBoundsCore(Rect) TransformBoundsCore(Rect)

Provides the means to override the TransformBounds behavior in a derived transform class.

(Inherited from GeneralTransform)

TransformPoint(Point) TransformPoint(Point) TransformPoint(Point)

Uses this transformation object's logic to transform the specified point, and returns the result.

(Inherited from GeneralTransform)

UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64)

Cancels a change notification that was previously registered by calling RegisterPropertyChangedCallback.

(Inherited from DependencyObject)

See Also