PointAnimationUsingKeyFrames 類別

定義

命名空間:

Windows.UI.Xaml.Media.Animation

沿著一組KeyFrame產生Point屬性值的動畫。

public ref class PointAnimationUsingKeyFrames sealed : Timeline

/// [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.UI.Xaml.Markup.ContentProperty(Name="KeyFrames")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class PointAnimationUsingKeyFrames final : Timeline

[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.UI.Xaml.Markup.ContentProperty(Name="KeyFrames")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class PointAnimationUsingKeyFrames : Timeline

Public NotInheritable Class PointAnimationUsingKeyFrames
Inherits Timeline

<PointAnimationUsingKeyFrames>
  oneOrMorePointKeyFrames
</PointAnimationUsingKeyFrames>

繼承

Object Platform::Object IInspectable DependencyObject Timeline PointAnimationUsingKeyFrames

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows 需求

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

範例

下列範例會沿著三角路徑來移動橢圓形。 此範例會使用 PointAnimationUsingKeyFrames 類別，以動畫顯示EllipseGeometry的Center屬性。 這個動畫會以下列方式使用三個主要畫面格：

1. 在前半秒期間，它會使用 LinearPointKeyFrame 類別的實例，將橢圓形沿著路徑的穩定速率從其起始位置移動。 線性主要畫面格，例如 LinearPointKeyFrame 會建立值之間的平滑線性插補。
2. 在下半秒結束時，它會使用 DiscretePointKeyFrame 類別的實例，突然將省略號沿著路徑移至下一個位置。 DiscretePointKeyFrame之類的離散主要畫面格會在值之間突然跳躍。
3. 在最後兩秒內，它會使用 SplinePointKeyFrame 類別的實例，將省略號移回其起始位置。 SplinePointKeyFrame之類的曲線主要畫面格會根據KeySpline屬性的值，在值之間建立變數轉換。 在此範例中，動畫一開始速度緩慢，然後在接近時間區段結尾時會以指數方式加速。

<Canvas Width="400" Height="300">
    <Canvas.Resources>
        <Storyboard x:Name="myStoryboard">

            <!-- Animating the Center property uses 3 KeyFrames, which animate
             the ellipse allong a triangular path. -->
            <PointAnimationUsingKeyFrames
          Storyboard.TargetProperty="Center"
          Storyboard.TargetName="MyAnimatedEllipseGeometry"
          Duration="0:0:5" RepeatBehavior="Forever" EnableDependentAnimation="True">

                <!-- Over the first half second, Using a LinearPointKeyFrame, the ellipse 
               moves steadily from its starting position along the first line of the 
               trianglar path.  -->
                <LinearPointKeyFrame KeyTime="0:0:0.5" Value="100,300" />

                <!-- Using a DiscretePointKeyFrame, the ellipse suddenly changes position
               after the first second of the animation. -->
                <DiscretePointKeyFrame KeyTime="0:0:1" Value="400,300" />

                <!-- Using a SplinePointKeyFrame, the ellipse moves back to its starting
               position. It moves slowly at first and then speeds up. This key frame 
               takes 2 seconds to complete. -->
                <SplinePointKeyFrame KeySpline="0.6,0.0 0.9,0.00" 
                 KeyTime="0:0:3" Value="200,100" />
            </PointAnimationUsingKeyFrames>
        </Storyboard>
    </Canvas.Resources>
    <Path Fill="Blue" Loaded="Start_Animation">
        <Path.Data>

            <!-- Describes an ellipse. -->
            <EllipseGeometry x:Name="MyAnimatedEllipseGeometry"
             Center="200,100" RadiusX="15" RadiusY="15" />
        </Path.Data>
    </Path>
</Canvas>

// Start the animation when the object loads
private void Start_Animation(object sender, RoutedEventArgs e)
{
    myStoryboard.Begin();
}

' Start the animation when the object loads
Private Sub Start_Animation(ByVal sender As Object, ByVal e As EventArgs)
    myStoryboard.Begin()
End Sub

建構函式

PointAnimationUsingKeyFrames()

初始化 PointAnimationUsingKeyFrames 類別的新實例。

屬性

AutoReverse	取得或設定值，其中該值指出時間軸是否會在完成向前反覆項目後反向播放。 (繼承來源 Timeline)
BeginTime	取得或設定這個 時間軸 應該開始的時間。 (繼承來源 Timeline)
Dispatcher	取得與此物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可以存取 UI 執行緒上DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject)
Duration	取得或設定這個時間表播放的時間長度 (不計算重複次數)。 (繼承來源 Timeline)
EnableDependentAnimation	取得或設定值，這個值會宣告是否應該允許考慮相依動畫的動畫屬性使用此動畫宣告。
EnableDependentAnimationProperty	識別 EnableDependentAnimation 相依性屬性。
FillBehavior	取得或設定值，指定動畫在到達其使用期間結束時的行為。 (繼承來源 Timeline)
KeyFrames	取得定義動畫的 PointKeyFrame 物件集合。
RepeatBehavior	取得或設定這個時間軸的重複行為。 (繼承來源 Timeline)
SpeedRatio	取得或設定相對於其父系的速率，此時會進行這個 時間軸。 (繼承來源 Timeline)

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	傳回針對相依性屬性所建立的任何基底值，如果動畫未使用中，則會套用。 (繼承來源 DependencyObject)
GetValue(DependencyProperty)	從 DependencyObject傳回相依性屬性的目前有效值。 (繼承來源 DependencyObject)
ReadLocalValue(DependencyProperty)	如果已設定本機值，則傳回相依性屬性的本機值。 (繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊通知函式，以接聽此DependencyObject實例上特定DependencyProperty的變更。 (繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)	在 DependencyObject上設定相依性屬性的本機值。 (繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback註冊的變更通知。 (繼承來源 DependencyObject)

事件

Completed

發生于 Storyboard 物件已完成播放時。 (繼承來源 Timeline)

另請參閱

• 腳本動畫