Timeline Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert eine Dauer und andere Verhaltenseigenschaften für eine Windows-Runtime Animation. Timeline ist die Basisklasse für Storyboard und alle Windows-Runtime Animationstypen, einschließlich derjenigen aus der Animationsbibliothek und derjenigen, die für benutzerdefinierte Animationen in visuellen Zuständen oder XAML auf Seitenebene verwendet werden.
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
- Vererbung
- Abgeleitet
- Attribute
Hinweise
Die Zeitachse definiert die Duration -Eigenschaft, die steuert, wie lange eine Animation einmal gestartet wird. Die Zeitachse definiert auch diese Verhaltenseigenschaften, die für alle Animationstypen gelten, und für Storyboard:
- AutoReverse
- Startzeit
- Fillbehavior
- RepeatBehavior
- SpeedRatio (nicht häufig verwendet)
Die Zeitachse definiert auch das "Completed "-Ereignis für Storyboard und Animationen. Die Behandlung des Abgeschlossenen Ereignisses ist nicht erforderlich oder die meisten Benutzeroberflächenanimationsszenarien.
Die Beziehung zwischen Storyboard und animationstypen besteht darin, dass ein Storyboard ein Container ist, der mehrere Animationen gruppieren kann, und fungiert als Controller zum Starten und Beenden der enthaltenen Animationen. Wenn Sie Zeitachseneigenschaften auf einem Storyboard im Gegensatz zu einzelnen Animationen innerhalb eines Storyboards festlegen, überschreiben die im Storyboard festgelegten Zeitachseneigenschaften diese in der Regel aus den kombinierten Animationen. Weitere Informationen finden Sie unter Storyboardanimationen.
Die Zeitachse verfügt über eine stark typierte Sammlungsklasse, die für Eigenschaften verwendet wird, die eine Reihe von Zeitachsenwerten verwenden, z. B. Storyboard.Children. Weitere Informationen finden Sie unter TimelineCollection.
Abgeleitete Zeitachsenklassen
Timeline ist die übergeordnete Klasse für mehrere sofort abgeleitete Klassen, die das Storyboardanimationssystem und auch die integrierten Bibliotheksanimationen unterstützen. Hier sind einige der wichtigen abgeleiteten Klassen:
Storyboard: Ein Container und Controller für andere Storyboardanimationen, die jeweils auf ein bestimmtes Objekt und eine bestimmte Eigenschaft abzielen.
Eingegebene Animationen: Jede dieser Animationen wird verwendet, um eine Eigenschaft zu animieren, die einen bestimmten Werttyp oder ein Objekt verwendet. + ColorAnimation, ColorAnimationUsingKeyFrames
- Objectanimationusingkeyframes
Designanimationen: Dies sind Animationen, die von der Animationsbibliothek definiert werden, die Sie für allgemeine UI-Interaktionen verwenden.+ DragItemThemeAnimation
- DragOverThemeAnimation
- DropTargetItemThemeAnimation
- FadeInThemeAnimation
- FadeOutThemeAnimation
- PointerDownThemeAnimation
- PointerUpThemeAnimation
- PopInThemeAnimation
- PopOutThemeAnimation
- RepositionThemeAnimation
- SplitCloseThemeAnimation
- SplitOpenThemeAnimation
- SwipeBackThemeAnimation
- SwipeHintThemeAnimation
Hinweis
Designübergänge werden nicht von der Zeitachse abgeleitet, sie werden von "Transition" abgeleitet.
Konstruktoren
| Name | Beschreibung |
|---|---|
| Timeline() |
Stellt das Initialisierungsverhalten der Basisklasse für von zeitachsen abgeleiteten Klassen bereit. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AllowDependentAnimations |
Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob abhängige Animationen in der gesamten App ausgeführt werden dürfen. |
| AutoReverse |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zeitachse rückwärts wiedergegeben wird, nachdem sie eine Vorwärts iteration abgeschlossen hat. |
| AutoReverseProperty |
Identifies the AutoReverse dependency property. |
| BeginTime |
Ruft die Uhrzeit ab, zu der diese Zeitachse beginnen soll, oder legt sie fest. |
| BeginTimeProperty |
Identifies the BeginTime dependency property. |
| Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
| DispatcherQueue |
Ruft ab |
| Duration |
Dient zum Abrufen oder Festlegen der Zeitdauer, für die diese Zeitachse wiedergegeben wird, ohne Wiederholungen zu zählen. |
| DurationProperty |
Identifies the Duration dependency property. |
| FillBehavior |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie sich die Animation verhält, nachdem sie das Ende des aktiven Zeitraums erreicht hat. |
| FillBehaviorProperty |
Identifies the FillBehavior dependency property. |
| RepeatBehavior |
Ruft das wiederholte Verhalten dieser Zeitachse ab oder legt dieses fest. |
| RepeatBehaviorProperty |
Identifies the RepeatBehavior dependency property. |
| SpeedRatio |
Dient zum Abrufen oder Festlegen der Rate relativ zum übergeordneten Element, zu dem der Zeitpunkt für diese Zeitachse voranschreitet. |
| SpeedRatioProperty |
Identifies for the SpeedRatio dependency property. |
Methoden
| Name | Beschreibung |
|---|---|
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject) |
| GetAnimationBaseValue(DependencyProperty) |
Gibt einen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject) |
| GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject) |
| ReadLocalValue(DependencyProperty) |
Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt wird. (Geerbt von DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (Geerbt von DependencyObject) |
| SetValue(DependencyProperty, Object) |
Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Completed |
Tritt auf, wenn die Wiedergabe des Storyboard-Objekts abgeschlossen wurde. |