LinearPointKeyFrame 類別

定義

命名空間:

Microsoft.UI.Xaml.Media.Animation

使用線性插補，從上一個主要畫面格的 Point 值動畫到它自己的 Value。

public ref class LinearPointKeyFrame 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 LinearPointKeyFrame 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 LinearPointKeyFrame : PointKeyFrame

Public NotInheritable Class LinearPointKeyFrame
Inherits PointKeyFrame

<LinearPointKeyFrame .../>

繼承

Object Platform::Object IInspectable DependencyObject PointKeyFrame LinearPointKeyFrame

屬性

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

備註

主要畫面格動畫允許多個目標值，這些值會在動畫時間軸的某個時間到達。 換句話說，每個主要畫面格都可以指定不同的中繼值，最後一個到達的主要畫面格就是最終的動畫值。 在動畫中指定多個值可以製作更複雜的動畫。 您通常會在 具有 LinearPointKeyFrame 的 PointAnimationUsingKeyFrames 中至少有兩個主要畫面格，否則 PointAnimation 會更簡單。

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

建構函式

LinearPointKeyFrame()

初始化 LinearPointKeyFrame 類別的新實例。

屬性

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