Timeline Klasse

Definition

Namespace:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

Definiert ein Zeitsegment.

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 Animatable

Public MustInherit Class Timeline
Inherits Animatable

Vererbung

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

Abgeleitet

System.Windows.Media.Animation.AnimationTimeline

System.Windows.Media.Animation.TimelineGroup

System.Windows.Media.MediaTimeline

Attribute

LocalizabilityAttribute RuntimeNamePropertyAttribute

Hinweise

Eine Zeitachse stellt ein Zeitsegment dar. Es stellt Eigenschaften bereit, mit denen Sie die Länge dieses Abschnitts angeben können, wann es beginnen soll, wie oft sie wiederholt wird, wie schnell die Zeit in diesem Segment voranschreitet und vieles mehr.

Klassen, die von der Zeitachsenklasse erben, bieten zusätzliche Funktionen, z. B. Animation und Medienwiedergabe. Im Folgenden finden Sie Beispiele für einige der verschiedenen Arten von spezialisierten Zeitachsen, die verfügbar sind.

• Animationen: Eine AnimationTimeline Art von Zeitachse, die Ausgabewerte erzeugt. Wenn Sie eine Animation einer Eigenschaft zuordnen, aktualisiert die Animation den Wert der Eigenschaft während der Wiedergabe, wodurch sie "animiert" wird. Eine Einführung in Animationen finden Sie unter "Animationsübersicht". Informationen zu den verschiedenen Methoden zum Anwenden von Animationen finden Sie in der Übersicht über Eigenschaftenanimationen.

• MediaTimelines: A MediaTimeline ist ein Zeitachsentyp, der die Wiedergabe einer Mediendatei steuert.

• ParallelTimelines: A ParallelTimeline ist ein Zeitachsentyp, der andere Zeitachsen gruppiert.

• Storyboards: A Storyboard ist ein spezieller Typ, der ParallelTimeline Objekt- und Eigenschaftenadressierungsinformationen für die darin enthaltenen Zeitachsen bereitstellt. Weitere Informationen zu Storyboard Objekten finden Sie in der Storyboards Overview.

Weitere Informationen zur Verwendung von Zeitachsen finden Sie in der Animationsübersicht. Eine Einführung in die Anzeigedauerfeatures von Zeitachsen finden Sie in der Übersicht über Timing-Verhaltensweisen.

Datenbindung und Animieren von Zeitachsen

Die meisten Zeitachseneigenschaften können datengebunden oder animiert werden; Aufgrund der Funktionsweise des Timing-Systems verhalten sich datengebundene oder animierte Zeitachsen jedoch nicht wie andere datengebundene oder animierte Objekte. Um ihr Verhalten zu verstehen, hilft es zu verstehen, was es bedeutet, eine Zeitachse zu aktivieren.

Wenn eine Zeitachse angewendet wird, werden Kopien aus der Zeitachse und den untergeordneten Zeitachsen erstellt. Diese Kopien werden fixiert (schreibgeschützt erstellt) und Clock Objekte werden daraus erstellt. Es sind diese Uhren, die die eigentliche Arbeit zum Animieren der zielbezogenen Eigenschaften ausführen. Wenn eine Zeitachse datengebunden oder animiert war, wurde beim Erstellen der Uhr eine Momentaufnahme der aktuellen Werte erstellt. Auch wenn sich die ursprüngliche Zeitachse möglicherweise weiterhin ändert, ist die Uhr nicht mehr vorhanden.

Damit eine Zeitachse Datenbindungs- oder Animationsänderungen widerspiegelt, muss die Uhr neu generiert werden. Uhren werden nicht automatisch für Sie regeneriert. Im Folgenden finden Sie verschiedene Möglichkeiten zum Anwenden von Zeitachsenänderungen:

• Wenn die Zeitachse zu einer StoryboardZeitachse gehört, können Sie diese Änderungen vornehmen, indem Sie das Storyboard mithilfe einer BeginStoryboard oder der Begin Methode erneut anwenden. Dies hat den Nebeneffekt, die Animation auch neu zu starten. Im Code können Sie die Seek Methode verwenden, um das Storyboard zurück zur vorherigen Position zu wechseln.

• Wenn Sie eine Animation mithilfe der BeginAnimation Methode direkt auf eine Eigenschaft angewendet haben, rufen Sie die BeginAnimation Methode erneut auf, und übergeben Sie sie an die Animation, die geändert wurde.

• Wenn Sie direkt auf der Taktebene arbeiten, erstellen Sie einen neuen Satz an Takten und wenden Sie ihn an, um den vorherigen Satz der generierten Takte zu ersetzen.

Ein Beispiel für eine datengebundene Animation finden Sie im Key Spline Animation Sample .

Verwenden einer Zeitachse als Timer

Die Uhr einer Zeitachse wird nur ausgeführt, wenn ein Ereignishandler damit verknüpft ist oder (im Fall eines AnimationClock Objekts) eine Eigenschaft zugeordnet ist. Aus diesem Grund (und andere) wird nicht empfohlen, einen Timeline Timer als Zeitgeber zu verwenden.

Konstruktoren

Name	Beschreibung
Timeline()	Initialisiert eine neue Instanz der Timeline-Klasse.
Timeline(Nullable<TimeSpan>, Duration, RepeatBehavior)	Initialisiert eine neue Instanz der Timeline Klasse mit dem angegebenen BeginTime, Durationund RepeatBehavior.
Timeline(Nullable<TimeSpan>, Duration)	Initialisiert eine neue Instanz der Timeline Klasse mit dem angegebenen BeginTime und Duration.
Timeline(Nullable<TimeSpan>)	Initialisiert eine neue Instanz der Timeline Klasse mit dem angegebenen BeginTime.

Felder

Name	Beschreibung
AccelerationRatioProperty	Identifies the AccelerationRatio dependency property.
AutoReverseProperty	Identifies the AutoReverse dependency property.
BeginTimeProperty	Identifies the BeginTime dependency property.
DecelerationRatioProperty	Identifies for the DecelerationRatio dependency property.
DesiredFrameRateProperty	Identifies the DesiredFrameRate attached property.
DurationProperty	Identifies the Duration dependency property.
FillBehaviorProperty	Identifies the FillBehavior dependency property.
NameProperty	Identifies the Name dependency property.
RepeatBehaviorProperty	Identifies the RepeatBehavior dependency property.
SpeedRatioProperty	Identifies for the SpeedRatio dependency property.

Eigenschaften

Name	Beschreibung
AccelerationRatio	Dient zum Abrufen oder Festlegen eines Werts, der den Prozentsatz des Zeitrahmens Duration angibt, der die Durchlaufzeit von Null auf seine maximale Rate beschleunigt.
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.
BeginTime	Dient zum Abrufen oder Festlegen der Uhrzeit, zu der dies Timeline beginnen soll.
CanFreeze	Ruft einen Wert ab, der angibt, ob das Objekt unveränderlich gemacht werden kann. (Geerbt von Freezable)
DecelerationRatio	Dient zum Abrufen oder Festlegen eines Werts, der den Prozentsatz des Zeitrahmens Duration angibt, der für die Verlangung der Zeit von der maximalen Rate auf Null aufgewendet wurde.
DependencyObjectType	Ruft den DependencyObjectType CLR-Typ dieser Instanz ab. (Geerbt von DependencyObject)
Dispatcher	Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
Duration	Dient zum Abrufen oder Festlegen der Zeitdauer, für die diese Zeitachse wiedergegeben wird, ohne Wiederholungen zu zählen.
FillBehavior	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie sich das Timeline Verhalten verhält, nachdem es das Ende des aktiven Zeitraums erreicht hat.
HasAnimatedProperties	Ruft einen Wert ab, der angibt, ob ein oder AnimationClock mehrere Objekte einer der Abhängigkeitseigenschaften dieses Objekts zugeordnet sind. (Geerbt von Animatable)
IsFrozen	Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann. (Geerbt von Freezable)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt). (Geerbt von DependencyObject)
Name	Dient zum Abrufen oder Festlegen des Namens dieses Timeline.
RepeatBehavior	Ruft das wiederholte Verhalten dieser Zeitachse ab oder legt dieses fest.
SpeedRatio	Dient zum Abrufen oder Festlegen der Rate relativ zum übergeordneten Element, zu dem der Zeitpunkt, zu Timelinedem dies fortschreitet.

Angefügte Eigenschaften

Name	Beschreibung
DesiredFrameRate	Ruft die gewünschte Framerate für diese Zeitachse und die untergeordneten Zeitachsen ab oder legt sie fest.

Methoden

Name	Beschreibung
AllocateClock()	Erstellt hierfür einen ClockTimeline.
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Wendet eine AnimationClock auf die angegebene DependencyProperty. Wenn die Eigenschaft bereits animiert ist, wird die angegebene HandoffBehavior Eigenschaft verwendet. (Geerbt von Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Wendet eine AnimationClock auf die angegebene DependencyProperty. Wenn die Eigenschaft bereits animiert ist, wird das SnapshotAndReplace Übergabeverhalten verwendet. (Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Wendet eine Animation auf die angegebene DependencyPropertyAnimation an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert ist, wird die angegebene HandoffBehavior Eigenschaft verwendet. (Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Wendet eine Animation auf die angegebene DependencyPropertyAnimation an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert ist, wird das SnapshotAndReplace Übergabeverhalten verwendet. (Geerbt von Animatable)
CheckAccess()	Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKey. (Geerbt von DependencyObject)
Clone()	Erstellt einen modifizierbaren Klon dieses TimelineObjekts, wodurch tiefe Kopien der Werte dieses Objekts erstellt werden.
CloneCore(Freezable)	Macht die Instanz zu einem Klon (deep copy) der angegebenen Freezable Basiseigenschaftswerte (nicht animiert). (Geerbt von Freezable)
CloneCurrentValue()	Erstellt einen modifizierbaren Klon dieses Timeline Objekts, wodurch tiefe Kopien der aktuellen Werte dieses Objekts erstellt werden.
CloneCurrentValueCore(Freezable)	Macht die Instanz zu einem modifizierbaren Klon (deep copy) des angegebenen Freezable Werts mit aktuellen Eigenschaftswerten. (Geerbt von Freezable)
CoerceValue(DependencyProperty)	Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle CoerceValueCallback in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen Funktionen aufgerufen werden, wie sie für den Aufruf DependencyObjectvorhanden sind. (Geerbt von DependencyObject)
CreateClock()	Erstellt ein neues, steuerbares Clock Steuerelement aus diesem Timeline. Wenn dies Timeline untergeordnete Elemente hat, wird ein Baum mit Uhren als Stamm erstellt Timeline .
CreateClock(Boolean)	Erstellt daraus Clock ein neues Timeline und gibt an, ob das neue Clock steuerelementierbar ist. Wenn dies Timeline untergeordnete Elemente hat, wird ein Baum mit Uhren als Stamm erstellt Timeline .
CreateInstance()	Initialisiert eine neue Instanz der Freezable-Klasse. (Geerbt von Freezable)
CreateInstanceCore()	Wenn sie in einer abgeleiteten Klasse implementiert wird, wird eine neue Instanz der Freezable abgeleiteten Klasse erstellt. (Geerbt von Freezable)
Equals(Object)	Bestimmt, ob ein bereitgestelltes DependencyObject Element dem aktuellen DependencyObjectentspricht. (Geerbt von DependencyObject)
Freeze()	Macht das aktuelle Objekt unveränderlich und legt seine IsFrozen Eigenschaft auf true. (Geerbt von Freezable)
FreezeCore(Boolean)	Macht dies Timeline unveränderlich oder bestimmt, ob sie unveränderlich gemacht werden kann.
GetAnimationBaseValue(DependencyProperty)	Gibt den nicht animierten Wert des angegebenen DependencyPropertyWerts zurück. (Geerbt von Animatable)
GetAsFrozen()	Erstellt eine fixierte Kopie der Freezablebasisbasierten (nicht animierten) Eigenschaftswerte. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte per Verweis kopiert. (Geerbt von Freezable)
GetAsFrozenCore(Freezable)	Macht diese Instanz zu einem Klon des angegebenen Timeline Objekts.
GetCurrentValueAsFrozen()	Erstellt eine fixierte Kopie der Freezable aktuellen Eigenschaftswerte. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte per Verweis kopiert. (Geerbt von Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Macht diese Instanz zu einem fixierten Klon des angegebenen Timeline. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, aber ihre aktuellen Werte sind.
GetDesiredFrameRate(Timeline)	Ruft die gewünschte Framerate der angegebenen Timelineab.
GetHashCode()	Ruft einen Hashcode für diese DependencyObjectab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen speziellen Enumerator, um zu bestimmen, welche Abhängigkeitseigenschaften lokal festgelegte Werte für diese DependencyObjectEigenschaft haben. (Geerbt von DependencyObject)
GetNaturalDuration(Clock)	Gibt die Länge einer einzelnen Iteration dieses TimelineWerts zurück.
GetNaturalDurationCore(Clock)	Gibt die Länge einer einzelnen Iteration dieses TimelineWerts zurück. Diese Methode stellt die Implementierung für GetNaturalDuration(Clock).
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz einer .DependencyObject (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
OnChanged()	Wird aufgerufen, wenn das aktuelle Freezable Objekt geändert wird. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Dieses Mitglied unterstützt die Windows Presentation Foundation-Infrastruktur (WPF) und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Stellt sicher, dass geeignete Kontextzeiger für ein DependencyObjectType soeben festgelegtes Datenelement eingerichtet werden. (Geerbt von Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Setzt die DependencyObject Implementierung OnPropertyChanged(DependencyPropertyChangedEventArgs) außer Kraft, um auch alle Changed Handler als Reaktion auf eine sich ändernde Abhängigkeitseigenschaft vom Typ Freezableaufzurufen. (Geerbt von Freezable)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden. (Geerbt von DependencyObject)
ReadPreamble()	Stellt sicher, dass der Freezable Zugriff über einen gültigen Thread erfolgt. Erber von Freezable müssen diese Methode am Anfang einer API aufrufen, die Datenmmber liest, die keine Abhängigkeitseigenschaften sind. (Geerbt von Freezable)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Geerbt von DependencyObject)
SetDesiredFrameRate(Timeline, Nullable<Int32>)	Legt die gewünschte Framerate der angegebenen .Timeline
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey Bezeichner der Abhängigkeitseigenschaft angegeben wird. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
VerifyAccess()	Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject)
WritePostscript()	Löst das Changed Ereignis für die Freezable Methode aus und ruft es OnChanged() auf. Klassen, die von Freezable dieser Methode abgeleitet werden, sollten am Ende einer API aufgerufen werden, die Klassenmmber ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind. (Geerbt von Freezable)
WritePreamble()	Überprüft, ob der Freezable Zugriff nicht fixiert ist und über einen gültigen Threadingkontext darauf zugegriffen wird. Freezable Vererbungen sollten diese Methode am Anfang einer API aufrufen, die in Datenmmber schreibt, die keine Abhängigkeitseigenschaften sind. (Geerbt von Freezable)

Ereignisse

Name	Beschreibung
Changed	Tritt auf, wenn das Freezable darin enthaltene Objekt geändert wird. (Geerbt von Freezable)
Completed	Tritt auf, wenn die Wiedergabe dieser Zeitachse vollständig abgeschlossen ist: Sie gibt den aktiven Zeitraum nicht mehr ein.
CurrentGlobalSpeedInvalidated	Tritt auf, wenn sich die Häufigkeit, mit der sich der Zeitverlauf für die Uhr der Zeitachse ändert.
CurrentStateInvalidated	Tritt auf, wenn die CurrentState Eigenschaft der Zeitachse Clock aktualisiert wird.
CurrentTimeInvalidated	Tritt auf, wenn die CurrentTime Eigenschaft der Zeitachse Clock aktualisiert wird.
RemoveRequested	Tritt auf, wenn die für diese Zeitachse oder eine der übergeordneten Zeitachsen erstellte Uhr entfernt wird.

Weitere Informationen

• Beispiel für Animationsdauerverhalten