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 对 EllipseGeometry 的 Center 属性进行动画处理。

// 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 属性指定的值前进到 To 属性指定的值。
• 发件人和依据： 动画从 From 属性指定的值发展到 由 From 和 By 属性的总和指定的值。
• 仅限： 动画从动画属性的基值或上一个动画的输出值发展到 To 属性指定的值。
• 仅按： 动画从要进行动画处理的属性的基值或上一个动画的输出值到该值的总和以及 By 属性指定的值。

PointAnimation 的 From、 By 或 To 属性不是 Point 值。 相反，对于 Point，这些是可以为 Null 的。 这些的默认值为 null，而不是未初始化的结构。 该 null 值是动画系统区分你尚未专门设置值的方式。 Visual C++ 组件扩展 (C++/CX) 不具有 Nullable 类型，因此它转而使用 IReference。

构造函数

属性

方法

事件

适用于

另请参阅

• Timeline
• PointAnimationUsingKeyFrames
• 情节提要动画
• XAML 动画示例
• Point