TranslateTransform 類別

定義

命名空間:

Windows.UI.Xaml.Media

轉譯 (移動) 二維 x-y 座標系統中的物件。

public ref class TranslateTransform sealed : Transform

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class TranslateTransform final : Transform

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class TranslateTransform : Transform

Public NotInheritable Class TranslateTransform
Inherits Transform

<TranslateTransform .../>

繼承

Object Platform::Object IInspectable DependencyObject GeneralTransform Transform TranslateTransform

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

此範例會使用 TranslateTransform 來位移文字。 在此範例中，主要文字下方文字的略微位移複本會建立陰影效果。

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

建構函式

TranslateTransform()

初始化 TranslateTransform 類別的新實例。

屬性

Dispatcher	取得與此物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可以存取 UI 執行緒上DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject)
Inverse	如果可能，取得這個 GeneralTransform的反向轉換。 (繼承來源 GeneralTransform)
InverseCore	在衍生或自訂GeneralTransform中實作Inverse傳回值的行為。 (繼承來源 GeneralTransform)
X	取得或設定沿著 X 軸平移的距離。
XProperty	識別 X 相依性屬性。
Y	取得或設定要沿著 Y 軸平移 (移動) 物件的距離。
YProperty	識別 Y 相依性屬性。

方法

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