TranslationAnimation 類別

定義

命名空間:

Windows.UI.Core.AnimationMetrics

提供方法，可讓您擷取轉譯 (移至新位置) 動畫的參數。

public ref class TranslationAnimation sealed : IPropertyAnimation

/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Core.AnimationMetrics.AnimationMetricsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class TranslationAnimation final : IPropertyAnimation

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.UI.Core.AnimationMetrics.AnimationMetricsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class TranslationAnimation : IPropertyAnimation

Public NotInheritable Class TranslationAnimation
Implements IPropertyAnimation

繼承

Object Platform::Object IInspectable TranslationAnimation

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

實作

IPropertyAnimation

Windows 需求

裝置系列	Windows Desktop Extension SDK (已於 10.0.10240.0 引進)
API contract	Windows.UI.Core.AnimationMetrics.AnimationMetricsContract (已於 v1.0 引進)

範例

若要取得 TranslationAnimation 類別的實例，請先取得動畫描述中的動畫集合，然後逐步解說該動畫陣列，以尋找任何屬於轉譯類型的動畫。 下列範例顯示此程式。 假設先前已指派 效果 和 目標 參數。

using Windows.UI.Core.AnimationMetrics;

AnimationDescription animationDescription = new AnimationDescription(effect, target);
foreach (var animation in animationDescription.Animations)
{
    switch (animation.Type)
    {
        case PropertyAnimationType.Scale:
            {
                ScaleAnimation scale = animation as ScaleAnimation;
                // Retrieve scale animation metrics.
            }
            break;
        case PropertyAnimationType.Translation:
            {
                TranslationAnimation scale = animation as TranslationAnimation;
                // Retrieve translation animation metrics.
            }
            break;
        case PropertyAnimationType.Opacity:
            {
                OpacityAnimation opacity = animation as OpacityAnimation;
                // Retrieve opacity animation metrics.
            }
            break;
    }
}

備註

若要執行翻譯動畫，請根據透過這個介面的方法所提供的時間資訊，將專案的位置從目前的位置移至其最終位置， (在版面配置變更之後) 物件的位置。

計時控制 控制項 Control1 和 Control2 指定三次貝茲曲線的第一和第二個控制點位置。 這兩個點的意義與 CSS 轉換計時函式 屬性中的意義相同。 控制點零一律 (0，0) ，而控制點三則一律 (1，1) 。 Control1和Control2的座標一律位於範圍 0 到 1，內含。

在產生的 Bézier 曲線上，x 座標代表時間，而 Y 座標代表進度。 從 (0，0) 到 (1，1) 的原始曲線會調整為符合動畫轉換的實際持續時間和範圍，因此 x=0 是轉換的開始時間，x=1 是結束時間，y=0 是動畫屬性的初始值，y=1 是最終值。 x 和 y 的值介於 0 到 1 之間，代表時間與動畫的對應中繼值。

屬性

Control1	取得三次方 Bézier 曲線的第一個控制點位置，該曲線描述翻譯如何隨著時間產生動畫效果。
Control2	取得三次方貝茲曲線的第二個控制點位置，該曲線描述翻譯在一段時間內應該如何產生動畫效果。
Delay	取得轉譯動畫開始的時間量，以及該動畫實際開始繪製的時間量。
Duration	取得應該執行翻譯動畫的時間量。 這不包括延遲。
Type	取得這個 物件表示的動畫類型。

另請參閱

• AnimationDescription
• 動畫計量範例