DiscretePointKeyFrame 類別

定義

命名空間:

Microsoft.UI.Xaml.Media.Animation

使用離散畫面格，從前一個主要畫面格的 Point 值動畫到它自己的 Value 。

public ref class DiscretePointKeyFrame sealed : PointKeyFrame

/// [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 DiscretePointKeyFrame final : PointKeyFrame

[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 DiscretePointKeyFrame : PointKeyFrame

Public NotInheritable Class DiscretePointKeyFrame
Inherits PointKeyFrame

<DiscretePointKeyFrame />

繼承

Object Platform::Object IInspectable DependencyObject PointKeyFrame DiscretePointKeyFrame

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

這個 XAML 範例會沿著三角形路徑移動橢圓形。 此範例使用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();
}

備註

主要畫面格動畫允許多個目標值，這些值會在動畫時間軸的某個時間到達。 換句話說，每個主要畫面格都可以指定不同的中繼值，最後一個到達的主要畫面格就是最終的動畫值。 在動畫中指定多個值可以製作更複雜的動畫。 您可以在相同的主要畫面格集合中混合離散、線性和曲線主要畫面格。

如需如何使用主要畫面格動畫的詳細資訊，請參閱 主要畫面格動畫和 Easing 函式動畫。

建構函式

DiscretePointKeyFrame()

初始化 DiscretePointKeyFrame 類別的新實例。

屬性

Dispatcher	一律會在Windows 應用程式 SDK應用程式中傳 null 回。 請改用 DispatcherQueue 。 (繼承來源 DependencyObject)
DispatcherQueue	DispatcherQueue取得與這個 物件相關聯的 。 DispatcherQueue表示即使程式碼是由非 UI 執行緒起始，也可以存取 DependencyObject UI 執行緒上的 設備。 (繼承來源 DependencyObject)
KeyTime	取得或設定應該到達主要畫面格目標 Value 的時間。 (繼承來源 PointKeyFrame)
Value	取得或設定主要畫面格的目標值。 (繼承來源 PointKeyFrame)

方法

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)

另請參閱

• PointKeyFrame
• PointAnimationUsingKeyFrames
• KeyTime
• Value
• 腳本動畫