Gets or sets the y-axis scale factor.
Assembly: PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
Values between 0 and 1 decrease the height of the scaled object; values greater than 1 increase the height of the scaled object. A value of 1 indicates that the object is not scaled in the y-direction.
Negative values flip the scaled object vertically. Values between 0 and -1 flip the scale object and decrease its height. Values less than -1 flip the object and increase its height. A value of -1 flips the scaled object but does not change its vertical size.
For more information and for examples, see How to: Scale an Element and How to: Flip a UIElement Horizontally or Vertically).
This example shows how to use a ScaleTransform to scale an element.
Use the ScaleX and properties to resize the element by the factor you specify. For example, a ScaleX value of 1.5 stretches the element to 150 percent of its original width. A value of 0.5 shrinks the height of an element by 50 percent.
Use the CenterX and CenterY properties to specify the point that is the center of the scale operation. By default, a ScaleTransform is centered at the point (0,0), which corresponds to the upper-left corner of the rectangle. This has the effect of moving the element and also of making it appear larger, because when you apply a Transform, you change the coordinate space in which the object resides.
<!-- Scales a rectangle by 200% from a center of (0,0).--> <Rectangle Height="50" Width="50" Fill="#CCCCCCFF" Stroke="Blue" StrokeThickness="2" Canvas.Left="100" Canvas.Top="100"> <Rectangle.RenderTransform> <ScaleTransform CenterX="0" CenterY="0" ScaleX="2" ScaleY="2" /> </Rectangle.RenderTransform> </Rectangle>
<!-- Scales a rectangle by 200% from a center of (25,25).--> <Rectangle Height="50" Width="50" Fill="#CCCCCCFF" Canvas.Left="100" Canvas.Top="100" Stroke="Blue" StrokeThickness="2"> <Rectangle.RenderTransform> <ScaleTransform CenterX="25" CenterY="25" ScaleX="2" ScaleY="2" /> </Rectangle.RenderTransform> </Rectangle>
The following illustration shows the difference between the two ScaleTransform operations. The dotted line shows the size and position of the rectangle before scaling.
For the complete sample, see 2-D Transforms Sample.
|How to: Flip a UIElement Horizontally or Vertically||This example shows how to use a ScaleTransform to flip a UIElement horizontally or vertically. In this example, a Button control (a type of UIElement) is flipped by applying a ScaleTransform to its RenderTransform property.|
|How to: Animate the Size of a FrameworkElement||To animate the size of a FrameworkElement, you can either animate its Width and Height properties or use an animated ScaleTransform.|
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2