Timeline 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
定义Windows 运行时动画的持续时间和其他行为属性。 Timeline 是 Storyboard 和所有Windows 运行时动画类型的基类,包括动画库中的动画类型以及用于视觉状态或页面级 XAML 中的自定义动画的动画类型。
public ref class Timeline : DependencyObject
/// [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 Timeline : DependencyObject
[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 class Timeline : DependencyObject
Public Class Timeline
Inherits DependencyObject
- 继承
- 派生
- 属性
注解
时间线定义 Duration 属性,该属性控制动画在启动后运行的时间长度。 时间线还定义了这些行为属性,这些属性对所有动画类型和 情节提要通用:
时间线还定义情节提要和动画的 Completed 事件。 处理 Completed 事件不是必需的,也不需要处理大多数 UI 动画方案。
情节提要和动画类型之间的关系是情节提要是一个容器,可以组合多个动画,并充当启动和停止包含的动画的控制器。 在 情节提要 上设置时间线属性而不是 情节提要中的单个动画时, 情节提要 中设置的时间线属性通常会替代组合动画中的这些属性。 有关详细信息,请参阅 情节提要动画。
Timeline 具有强类型集合类,该类用于采用一组 Timeline 值的属性,例如 Storyboard.Children。 有关详细信息,请参阅 TimelineCollection。
时间线 派生类
Timeline 是支持情节提要动画系统和内置库动画的多个即时派生类的父类。 下面是一些值得注意的派生类:
情节提要:其他情节提要动画的容器和控制器,每个动画都以特定对象和属性为目标。
类型化动画:其中每个动画都用于对采用特定值类型或对象的属性进行动画处理。 + ColorAnimation、 ColorAnimationUsingKeyFrames
主题动画:这些是由用于常见 UI 交互的动画库定义的动画。+ DragItemThemeAnimation
注意
主题切换不派生自时间线,它们派生自 切换效果。
构造函数
Timeline() |
为 时间线派生类提供基类初始化行为。 |
属性
AllowDependentAnimations |
获取或设置一个值,该值确定是否应允许依赖动画在整个应用中运行。 |
AutoReverse |
获取或设置一个值,该值指示时间线在完成向前迭代后是否按相反的顺序播放。 |
AutoReverseProperty |
标识 AutoReverse 依赖属性。 |
BeginTime |
获取或设置此 时间线 应开始的时间。 |
BeginTimeProperty |
标识 BeginTime 依赖属性。 |
Dispatcher |
始终在Windows 应用 SDK应用中返回 |
DispatcherQueue |
获取 |
Duration |
获取或设置此时间线播放的时间长度,而不是计数重复。 |
DurationProperty |
标识 Duration 依赖属性。 |
FillBehavior |
获取或设置一个值,该值指定动画在其活动周期结束时的行为方式。 |
FillBehaviorProperty |
标识 FillBehavior 依赖属性。 |
RepeatBehavior |
获取或设置此时间线的重复行为。 |
RepeatBehaviorProperty |
标识 RepeatBehavior 依赖属性。 |
SpeedRatio |
获取或设置相对于其父级的速率,此时此 时间线的进度。 |
SpeedRatioProperty |
标识 SpeedRatio 依赖属性。 |
方法
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 对象完成播放时发生。 |