ScaleTransform 类

定义

命名空间:

Microsoft.UI.Xaml.Media

在二维 x-y 坐标系中缩放对象。

public ref class ScaleTransform sealed : Transform

/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ScaleTransform final : Transform

[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ScaleTransform : Transform

Public NotInheritable Class ScaleTransform
Inherits Transform

<ScaleTransform .../>

继承

Object Platform::Object IInspectable DependencyObject GeneralTransform Transform ScaleTransform

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

示例

此 XAML 示例使用 ScaleTransform 从其原始大小缩放文本。

<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="2.0" />
        </TextBlock.RenderTransform>
    </TextBlock>
</StackPanel>

应用转换后，文本如下所示：

此示例演示如何在运行时访问和修改代码中的转换。 每次按下矩形时，比例都会增加。

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

构造函数

ScaleTransform()

初始化 ScaleTransform 类的新实例。

属性

CenterX	获取或设置此 ScaleTransform 的中心点的 x 坐标。
CenterXProperty	标识 CenterX 依赖属性。
CenterY	获取或设置此 ScaleTransform 的中心点的 y 坐标。
CenterYProperty	标识 CenterY 依赖属性。
Dispatcher	始终在Windows 应用 SDK应用中返回 null 。 请改用 DispatcherQueue 。 (继承自 DependencyObject)
DispatcherQueue	DispatcherQueue获取与此对象关联的 。 表示 DispatcherQueue 一个可以在 UI 线程上访问 DependencyObject 的设施，即使代码是由非 UI 线程启动的。 (继承自 DependencyObject)
Inverse	获取此 GeneralTransform 的反转换（如果可能）。 (继承自 GeneralTransform)
InverseCore	在派生的或自定义的 GeneralTransform 中实现 Inverse 的返回值的行为。 (继承自 GeneralTransform)
ScaleX	获取或设置 x 轴缩放比例。
ScaleXProperty	标识 ScaleX 依赖属性。
ScaleY	获取或设置 y 轴比例系数。
ScaleYProperty	标识 ScaleY 依赖属性。

方法

ClearValue(DependencyProperty)	清除依赖属性的本地值。 (继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject)
GetValue(DependencyProperty)	从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	注册通知函数，用于侦听此 DependencyObject 实例上对特定 DependencyProperty 的更改。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject)
TransformBounds(Rect)	变换指定的边界框，并返回一个正好能容纳它的轴对齐的边界框。 (继承自 GeneralTransform)
TransformBoundsCore(Rect)	提供替代派生转换类中 TransformBounds 行为的方法。 (继承自 GeneralTransform)
TransformPoint(Point)	使用此转换对象的逻辑来转换指定的点，并返回结果。 (继承自 GeneralTransform)
TryTransform(Point, Point)	尝试变换指定的点，并返回指示变换是否成功的值。 (继承自 GeneralTransform)
TryTransformCore(Point, Point)	提供替代派生转换类中 TryTransform 行为的方法。 (继承自 GeneralTransform)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject)

另请参阅

• Transform
• XAML 二维转换示例