PointAnimation 類別

定義

public ref class PointAnimation sealed : Timeline

/// [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 PointAnimation final : Timeline

[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 PointAnimation : Timeline

Public NotInheritable Class PointAnimation
Inherits Timeline

<PointAnimation .../>

繼承

Object Platform::Object IInspectable DependencyObject Timeline PointAnimation

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

以下範例展示了如何使用 PointAnimation 來動畫橢圓幾何體的中心屬性。

// Start the animation when the object loads
void SampleApp::Page::Start_Animation(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
    myStoryboard->Begin();
}

<Canvas Width="450" Height="350">
    <Canvas.Resources>
        <Storyboard x:Name="myStoryboard">

            <!-- Animate the center point of the ellipse from 100 X, 300 Y
             to 400 X, 100 Y over 5 seconds. -->
            <PointAnimation
             Storyboard.TargetProperty="Center"
             Storyboard.TargetName="MyAnimatedEllipseGeometry"
             Duration="0:0:5" 
             From="100,300"
             To="400,100"
             RepeatBehavior="Forever" EnableDependentAnimation="True"/>

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

備註

使用 PointAnimation 來動畫任何類型為 Point 的相依屬性的屬性值。

點的線性插 值表示X 和 Y 的值被視為一個數字，插值僅是數學運算。

有時你需要使用間接屬性目標來鎖定另一個物件的子屬性，該屬性在目標上的屬性值。 例如，要動畫 PathGeometry 的部分，你需要參考一些中間物件屬性值，直到間接屬性路徑的最後一步真正成為 Point 值。 欲了解更多關於間接屬性目標及其他分鏡動畫概念的資訊，請參閱 分鏡動畫 或 屬性路徑語法。

PointAnimation 通常至少設定一個 From、 By 或 To 屬性，但不會同時具備三個屬性。

• 僅來自： 動畫會從 From 屬性指定的值進展到被動畫屬性的基值。
• 發件與收件人： 動畫會從 From 屬性指定的值進展到 To 屬性指定的值。
• 作者與作者： 動畫會從 From 屬性指定的值進展到由 From 屬性與 By 屬性總和所指定的值。
• 只給： 動畫會從被動畫屬性的基底值或先前動畫的輸出值，逐步推進到 To 屬性指定的值。
• 僅由： 動畫會從被動畫屬性的基值或先前動畫的輸出值，逐步累積到該值與 By 屬性指定的值之總和。

PointAnimation 的 From、 By 或 To 屬性並不是 點 數值。 相反地，這些是點數的可取消。 這些的預設值為 null，而非未初始化的結構。 這個 空 值就是動畫系統區分你沒有特別設定值的方式。 C++ 沒有 Nullable 型別，所以改用 IReference 。

另請參閱

• Timeline
• PointAnimationUsingKeyFrames
• 分鏡腳本動畫
• XAML 動畫範例
• Point