ScaleTransform ScaleTransform ScaleTransform ScaleTransform Class

Definition

Scales an object in the two-dimensional x-y coordinate system.

public : sealed class ScaleTransform : Transform, IScaleTransform
struct winrt::Windows::UI::Xaml::Media::ScaleTransform : Transform, IScaleTransform
public sealed class ScaleTransform : Transform, IScaleTransform
Public NotInheritable Class ScaleTransform Inherits Transform Implements IScaleTransform
<ScaleTransform .../>
Inheritance
ScaleTransformScaleTransformScaleTransformScaleTransform
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Examples

This XAML example uses a ScaleTransform to scale text from its original size.

<StackPanel>
    <TextBlock FontFamily="Verdana"
               FontSize="32"
               FontWeight="Bold" 
               Foreground="SteelBlue"
               Text="Scaled Text" />

    <!-- Scale the text width using a ScaleTransform. -->
    <TextBlock FontFamily="Verdana"
               FontSize="32"
               FontWeight="Bold"
               Foreground="SteelBlue"
               Text="Scaled Text">
        <TextBlock.RenderTransform>
            <ScaleTransform ScaleX="1.5" ScaleY="1.0" />
        </TextBlock.RenderTransform>
    </TextBlock>

    <!-- Scale the text height using a ScaleTransform. -->
    <TextBlock FontFamily="Verdana"
               FontSize="32"
               FontWeight="Bold" 
               Foreground="SteelBlue"
               Text="Scaled Text">
        <TextBlock.RenderTransform>
            <ScaleTransform ScaleX="1.0" ScaleY="1.5" />
        </TextBlock.RenderTransform>
    </TextBlock>
</StackPanel>

The text looks like this after the transform is applied.

Text with a skew transform applied

This example shows how you can access and modify a transform in code at runtime. Each time the rectangle is pressed, the skew is increased.

<StackPanel>
  <Rectangle PointerPressed="HandlePointerPressed"
    Width="50" Height="50" Fill="RoyalBlue">
    <Rectangle.RenderTransform>

      <!-- If you give the transform a name you can 
        access it easily from code. -->
      <ScaleTransform x:Name="myScaleTransform" />
    </Rectangle.RenderTransform>
  </Rectangle>
</StackPanel>
private void HandlePointerPressed(object sender, PointerRoutedEventArgs e)
{
    // Increase ScaleX and ScaleY by 25%.
    myScaleTransform.ScaleX = myScaleTransform.ScaleX * 1.25;
    myScaleTransform.ScaleY = myScaleTransform.ScaleY * 1.25;
}
Private Sub HandlePointerPressed(ByVal sender As Object, ByVal e As PointerRoutedEventArgs)
    ' Increase ScaleX and ScaleY by 25%.
    myScaleTransform.ScaleX = (myScaleTransform.ScaleX * 1.25)
    myScaleTransform.ScaleY = (myScaleTransform.ScaleY * 1.25)
End Sub

Here's the rectangle after it's been pressed twice.

A rectangle with a skew transform applied

Constructors

ScaleTransform() ScaleTransform() ScaleTransform() ScaleTransform()

Initializes a new instance of the ScaleTransform class.

Properties

CenterX CenterX CenterX CenterX

Gets or sets the x-coordinate of the center point of this ScaleTransform.

CenterXProperty CenterXProperty CenterXProperty CenterXProperty

Identifies the CenterX dependency property.

CenterY CenterY CenterY CenterY

Gets or sets the y-coordinate of the center point of this ScaleTransform.

CenterYProperty CenterYProperty CenterYProperty CenterYProperty

Identifies the CenterY dependency property.

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

Gets the inverse transformation of this GeneralTransform, if possible.

(Inherited from GeneralTransform)
InverseCore InverseCore InverseCore InverseCore

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

(Inherited from GeneralTransform)
ScaleX ScaleX ScaleX ScaleX

Gets or sets the x-axis scale factor.

ScaleXProperty ScaleXProperty ScaleXProperty ScaleXProperty

Identifies the ScaleX dependency property.

ScaleY ScaleY ScaleY ScaleY

Gets or sets the y-axis scale factor.

ScaleYProperty ScaleYProperty ScaleYProperty ScaleYProperty

Identifies the ScaleY dependency property.

Methods

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

Clears the local value of a dependency property.

(Inherited from DependencyObject)
GetAnimationBaseValue(DependencyProperty) 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) GetValue(DependencyProperty)

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

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty) 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) 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) SetValue(DependencyProperty,Object)

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

(Inherited from DependencyObject)
TransformBounds(Rect) 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) TransformBoundsCore(Rect)

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

(Inherited from GeneralTransform)
TransformPoint(Point) 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) UnregisterPropertyChangedCallback(DependencyProperty,Int64)

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

(Inherited from DependencyObject)

See Also