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 二維轉換範例