Timeline 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
定義一段時間。
public ref class Timeline abstract : System::Windows::Media::Animation::Animatable[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public abstract class Timeline : System.Windows.Media.Animation.Animatable[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type Timeline = class
inherit AnimatablePublic MustInherit Class Timeline
Inherits Animatable- 繼承
- 衍生
- 屬性
備註
時間軸代表時間區段。 它提供的屬性可讓您指定時間片段長度、應開始的時間、重複次數、時間在該片段中的播放速度等等。
從時間軸類別繼承的類別提供額外功能，例如，動畫和媒體播放。 以下是一些不同類型的特製化時程表範例。
動畫：是 AnimationTimeline 產生輸出值的時程表類型。 當您將動畫與屬性產生關聯時，動畫會在播放時更新屬性的值，藉此「產生動畫效果」。 如需動畫簡介，請參閱 動畫概觀。 如需套用動畫之不同方式的詳細資訊，請參閱 屬性動畫技術概觀。
MediaTimelines：是 MediaTimeline 控制媒體檔案播放的時程表類型。
ParallelTimelines：A ParallelTimeline 是將其他時程表分組的時程表類型。
分鏡腳本：是 Storyboard 的特殊類型 ParallelTimeline ，可提供對象和屬性目標資訊給它所包含的時程表。 如需對象的詳細資訊 Storyboard ，請參閱 分鏡腳本概觀。
如需使用時程表的詳細資訊，請參閱 動畫概觀。 如需時間軸計時功能的簡介，請參閱 計時行為概觀。
數據系結和動畫時程表
大部分的時間軸屬性都可以是系結或動畫的數據;不過，由於計時系統的運作方式，數據系結或動畫時間軸的行為不像其他數據系結或動畫物件。 若要瞭解其行為，它有助於瞭解啟用時程表的意義。
套用時程表時，會建立時程表及其子時程表的複本。 這些複本會凍結 (建立只讀) ，並從 Clock 中建立物件。 這些時鐘會執行以動畫顯示目標屬性的實際工作。 如果時間軸是系結或動畫的數據，則會在建立其時鐘時建立其目前值的快照集。 即使原始時間軸可能會繼續變更，但其時鐘也不會變更。
若要讓時程表反映數據系結或動畫變更，必須重新產生其時鐘。 時鐘不會自動產生。 以下是幾種可套用時間軸變更的方式︰
如果時程表是 或 屬於 Storyboard，您可以使用 或 Begin 方法重新套用BeginStoryboard其分鏡腳本來反映變更。 這也會一併重新啟動動畫。 在程式代碼中 Seek ，您可以使用 方法將分鏡腳本前進回其先前的位置。
如果您使用 方法直接將動畫套用至屬性 BeginAnimation ，請再次呼叫 BeginAnimation 方法，並傳遞已修改的動畫。
如果您直接在時鐘層級運作，請建立並套用一組新的時鐘，並使用它們來取代前一組產生的時鐘。
如需資料綁定動畫的範例，請參閱 主要曲線動畫範例 。
使用時程表做為定時器
只有在有與其相關聯的事件處理程式或 (AnimationClock 物件時，時間軸的時鐘才會進行，) 它與屬性相關聯。 基於這個理由， (和其他) ，建議您不要使用 Timeline 做為定時器。
建構函式
欄位
| AccelerationRatioProperty |
識別 AccelerationRatio 相依性屬性。 |
| AutoReverseProperty |
識別 AutoReverse 相依性屬性。 |
| BeginTimeProperty |
識別 BeginTime 相依性屬性。 |
| DecelerationRatioProperty |
為 DecelerationRatio 相依性屬性識別。 |
| DesiredFrameRateProperty |
識別 DesiredFrameRate 附加屬性。 |
| DurationProperty |
識別 Duration 相依性屬性。 |
| FillBehaviorProperty |
識別 FillBehavior 相依性屬性。 |
| NameProperty |
識別 Name 相依性屬性。 |
| RepeatBehaviorProperty |
識別 RepeatBehavior 相依性屬性。 |
| SpeedRatioProperty |
為 SpeedRatio 相依性屬性識別。 |
屬性
| AccelerationRatio |
取得或設定值，這個值指定時間軸的 Duration 在從零加速至其最大速率所經過時間的百分比。 |
| AutoReverse |
取得或設定值，其中該值指出時間軸是否會在完成向前反覆項目後反向播放。 |
| BeginTime |
取得或設定這個 Timeline 應該開始的時間。 |
| CanFreeze |
取得值，指出是否可以將物件設為不可修改。 (繼承來源 Freezable) |
| DecelerationRatio |
取得或設定值，指定時間軸的 Duration 在從其最大速率減速至零所經過時間的百分比。 |
| DependencyObjectType |
取得包裝 DependencyObjectType 這個實體 CLR 型別的 。 (繼承來源 DependencyObject) |
| Dispatcher |
取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject) |
| Duration |
取得或設定這個時間表播放的時間長度 (不計算重複次數)。 |
| FillBehavior |
取得或設定值，該值指定 Timeline 在作用期結束後的行為。 |
| HasAnimatedProperties |
取得值，這個值表示是否有一個或多個 AnimationClock 物件與這個物件的任何一個相依性屬性相關聯。 (繼承來源 Animatable) |
| IsFrozen |
取得值，該值表示物件目前是否可修改。 (繼承來源 Freezable) |
| IsSealed |
取得值，這個值表示此執行個體目前是否已密封 (唯讀)。 (繼承來源 DependencyObject) |
| Name |
取得或設定這個 Timeline 的名稱。 |
| RepeatBehavior |
取得或設定這個時間軸的重複行為。 |
| SpeedRatio |
取得或設定這個 Timeline 相對於其父代的時間進行比率。 |
附加屬性
| DesiredFrameRate |
取得或設定此時刻表及其子時刻表理想的畫面播放速率。 |
方法
事件
| Changed |
發生於 Freezable 或所含的物件遭到修改時。 (繼承來源 Freezable) |
| Completed |
當這個時刻表完全結束播放時會發生：它不會再進入其作用期。 |
| CurrentGlobalSpeedInvalidated |
發生於時刻表時鐘的時間進行速率變更時。 |
| CurrentStateInvalidated |
於時間軸的 Clock 之 CurrentState 屬性更新時發生。 |
| CurrentTimeInvalidated |
於時間軸的 Clock 之 CurrentTime 屬性更新時發生。 |
| RemoveRequested |
為這個時刻表建立時鐘或移除它的其中一個父時刻表時發生。 |
