Timeline 類別

  • 參考

定義

命名空間:
Microsoft.UI.Xaml.Media.Animation
編輯

定義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
繼承
Object Platform::Object IInspectable DependencyObject Timeline
衍生
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

備註

時間軸會定義 Duration 屬性，控制動畫啟動後執行的時間長度。 時間軸也會定義這些行為屬性，這些屬性適用于所有動畫類型，以及 Storyboard：

時間軸也會定義Storyboard和動畫的Completed事件。 處理 Completed 事件並非必要或大部分的 UI 動畫案例。

Storyboard與動畫類型之間的關聯性是Storyboard是可分組多個動畫的容器，並做為啟動和停止內含動畫的控制器。 當您在 Storyboard 上設定 Timeline 屬性，而不是 分鏡腳本內的個別動畫時， Storyboard 中設定的 Timeline 屬性通常會覆寫合併動畫中的時間軸屬性。 如需詳細資訊，請參閱 腳本動畫。

Timeline 具有強型別的集合類別，用於採用一組 Timeline 值的屬性，例如 Storyboard.Children。 如需詳細資訊，請參閱 TimelineCollection。

時間軸 衍生類別

Timeline 是數個立即衍生類別的父類別，可支援腳本動畫系統，以及內建的程式庫動畫。 以下是一些值得注意的衍生類別：

注意

主題轉換不會衍生自時間軸，它們衍生自 Transition。

建構函式

Timeline()

提供 時間軸衍生類別的基類初始化行為。

屬性

AllowDependentAnimations

取得或設定值，這個值會決定是否允許在整個應用程式中執行相依動畫。
AutoReverse

取得或設定值，其中該值指出時間軸是否會在完成向前反覆項目後反向播放。
AutoReverseProperty

識別 AutoReverse 相依性屬性。
BeginTime

取得或設定這個 時間軸 應該開始的時間。
BeginTimeProperty

識別 BeginTime 相依性屬性。
Dispatcher

一律會在Windows 應用程式 SDK應用程式中傳 null 回。 請改用 DispatcherQueue 。

(繼承來源 DependencyObject)
DispatcherQueue

DispatcherQueue取得與這個 物件相關聯的 。 DispatcherQueue表示即使程式碼是由非 UI 執行緒起始，也可以存取 DependencyObject UI 執行緒上的 設備。

(繼承來源 DependencyObject)
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 物件已完成播放時。

適用於

另請參閱