ByteAnimation Klasse

Referenz

Definition

Namespace:: System.Windows.Media.Animation

Assembly:: PresentationCore.dll

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.

Erstellt eine Animation des Werts einer Byte-Eigenschaft zwischen zwei Zielwerten unter Verwendung der linearen Interpolation für eine angegebene Duration.

public ref class ByteAnimation : System::Windows::Media::Animation::ByteAnimationBase

public class ByteAnimation : System.Windows.Media.Animation.ByteAnimationBase

type ByteAnimation = class
    inherit ByteAnimationBase

Public Class ByteAnimation
Inherits ByteAnimationBase

Vererbung: Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

AnimationTimeline

ByteAnimationBase
ByteAnimation

Hinweise

Eine Animation aktualisiert den Wert einer Eigenschaft über einen bestimmten Zeitraum. Ein Animationseffekt kann subtil sein, z. B. das Verschieben einiger Shape Pixel nach links und rechts oder dramatisch, z. B. das Vergrößern eines Objekts auf das 200-Fache seiner ursprünglichen Größe, während es gedreht und seine Farbe geändert wird. Um eine Animation in Windows Presentation Foundation (WPF) zu erstellen, ordnen Sie eine Animation dem Eigenschaftswert eines Objekts zu.

Zielwerte

Die ByteAnimation -Klasse erstellt einen Übergang zwischen zwei Zielwerten. Verwenden Sie zum Festlegen der Zielwerte die FromEigenschaften , Tound By . In der folgenden Tabelle ist zusammengefasst, wie die Eigenschaften From, To und By zusammen oder getrennt verwendet werden können, um die Zielwerte einer Animation zu bestimmen.

Angegebene Eigenschaften	Resultierendes Verhalten
From	Die Ausführung der Animation erfolgt ab dem von der From-Eigenschaft angegebenen Wert bis zum Basiswert der animierten Eigenschaft oder zum Ausgabewert einer vorherigen Animation, je nach Konfiguration der vorherigen Animation.
From und To	Die Animation verläuft von dem durch die From-Eigenschaft angegebenen Wert bis zum durch die To-Eigenschaft angegebenen Wert.
From und By	Die Animation verläuft von dem durch die From-Eigenschaft angegebenen Wert bis zu dem Wert, der durch die Summe der Eigenschaften From und By angegeben wird.
To	Die Ausführung der Animation erfolgt ab dem Basiswert der animierten Eigenschaft oder dem Ausgabewert einer vorherigen Animation bis zum von der To-Eigenschaft angegebenen Wert.
By	Die Ausführung der Animation erfolgt ab dem Basiswert der animierten Eigenschaft oder dem Ausgabewert einer vorherigen Animation bis zum Wert, der durch die Summe dieses Werts und des von der By-Eigenschaft angegebenen Werts gebildet wird.

Hinweis

Wenn Sie sowohl die To Eigenschaften als By auch festlegen, hat die To Eigenschaft Vorrang, und die By Eigenschaft wird ignoriert.

Um andere Interpolationsmethoden zu verwenden oder zwischen mehr als zwei Zielwerten zu animieren, verwenden Sie ein ByteAnimationUsingKeyFrames -Objekt.

Informationen zum Anwenden mehrerer Animationen auf eine einzelne Eigenschaft finden Sie unter Übersicht über Keyframe-Animationen.

Features von Freezable

Da die ByteAnimation -Klasse von Freezableerbt, ByteAnimation erhalten Objekte mehrere besondere Features, die folgendes umfassen: Sie können als Ressourcen deklariert, für mehrere Objekte freigegeben, schreibgeschützt gemacht werden, um die Leistung zu verbessern, geklont und threadsicher gemacht werden. Weitere Informationen zu den verschiedenen Funktionen, die Freezable-Objekte bieten, finden Sie unter Übersicht über Freezable-Objekte.

Konstruktoren

ByteAnimation()	Initialisiert eine neue Instanz der ByteAnimation-Klasse.
ByteAnimation(Byte, Byte, Duration)	Initialisiert eine neue Instanz der ByteAnimation-Klasse, die eine Animation über die angegebene Dauer vom angegebenen Anfangswert bis zum angegebenen Zielwert erstellt.
ByteAnimation(Byte, Byte, Duration, FillBehavior)	Initialisiert eine neue Instanz der ByteAnimation-Klasse, die eine Animation über die angegebene Dauer vom angegebenen Anfangswert bis zum angegebenen Zielwert erstellt und das angegebene Füllungsverhalten aufweist.
ByteAnimation(Byte, Duration)	Initialisiert eine neue Instanz der ByteAnimation-Klasse, die eine Animation über den angegebenen Zeitraum bis zum angegebenen Wert erzeugt. Der Startwert der Animation ist der Basiswert der zu animierenden Eigenschaft oder der Ausgabewert einer anderen Animation.
ByteAnimation(Byte, Duration, FillBehavior)	Initialisiert eine neue Instanz der ByteAnimation-Klasse, die eine Animation über die angegebene Dauer bis zum angegebenen Wert erstellt und das angegebene Füllungsverhalten aufweist. Der Startwert der Animation ist der Basiswert der zu animierenden Eigenschaft oder der Ausgabewert einer anderen Animation.

Felder

ByProperty	Bezeichnet die By-Abhängigkeitseigenschaft.
EasingFunctionProperty	Bezeichnet die EasingFunction-Abhängigkeitseigenschaft.
FromProperty	Bezeichnet die From-Abhängigkeitseigenschaft.
ToProperty	Bezeichnet die To-Abhängigkeitseigenschaft.

Eigenschaften

AccelerationRatio	Ruft einen Wert ab oder legt diesen fest, der den Prozentsatz der Duration der Zeitachse angibt, der für die Beschleunigung des Zeitverlaufs von null bis zur maximalen Rate aufgewendet wird. (Geerbt von Timeline)
AutoReverse	Ruft einen Wert ab, der angibt, ob die Zeitachse nach einem vollständigen Durchgang vorwärts in umgekehrter Reihenfolge abspielt. (Geerbt von Timeline)
BeginTime	Ruft die Uhrzeit ab oder legt sie fest, bei der diese Timeline beginnen soll. (Geerbt von Timeline)
By	Ruft den Gesamtbetrag ab, um den die Animation ihren Startwert ändert, oder legt diesen fest.
CanFreeze	Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann. (Geerbt von Freezable)
DecelerationRatio	Ruft einen Wert ab oder legt diesen fest, der den Prozentsatz der Duration der Zeitachse angibt, der für die Verlangsamung des Zeitverlaufs von der maximalen Rate auf null aufgewendet wird. (Geerbt von Timeline)
DependencyObjectType	Ruft den ab, der DependencyObjectType den CLR-Typ dieses instance umschließt. (Geerbt von DependencyObject)
Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
Duration	Ruft die Zeitdauer ab, für die diese Zeitachse wiedergegeben wird, ohne Wiederholungen, oder legt diese fest. (Geerbt von Timeline)
EasingFunction	Ruft die auf diese Animation angewendete Beschleunigungsfunktion ab oder legt sie fest.
FillBehavior	Ruft einen Wert ab oder legt einen Wert fest, der angibt, wie sich Timeline verhält, wenn das Ende des aktiven Zeitraums erreicht wurde. (Geerbt von Timeline)
From	Ruft den Anfangswert der Animation ab oder legt ihn fest.
HasAnimatedProperties	Ruft einen Wert ab, der angibt, ob einer der Abhängigkeitseigenschaften dieses Objekts ein oder mehrere AnimationClock-Objekte zugeordnet sind. (Geerbt von Animatable)
IsAdditive	Ruft einen Wert ab, der angibt, ob der aktuelle Wert der Zieleigenschaft zum Anfangswert dieser Animation hinzugefügt werden soll, oder legt diesen Wert fest.
IsCumulative	Ruft einen Wert ab, der angibt, ob der Wert der Animation akkumuliert wird, wenn er wiederholt wird, oder legt ihn fest.
IsDestinationDefault	Ruft einen Wert ab, der angibt, ob diese Animation den defaultDestinationValue-Parameter der GetCurrentValue(Object, Object, AnimationClock)-Methode als Zielwert verwendet. (Geerbt von AnimationTimeline)
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 derzeit versiegelt (schreibgeschützt) ist. (Geerbt von DependencyObject)
Name	Ruft den Namen dieser Timeline ab oder legt diesen fest. (Geerbt von Timeline)
RepeatBehavior	Ruft das Wiederholungsverhalten dieser Zeitachse ab oder legt es fest. (Geerbt von Timeline)
SpeedRatio	Ruft die Geschwindigkeit ab, mit der die Zeit für diese Timeline, relativ zum übergeordneten Element, verläuft, oder legt diese fest. (Geerbt von Timeline)
TargetPropertyType	Ruft den Typ des Werts ab, den diese Animation generiert. (Geerbt von ByteAnimationBase)
To	Ruft den Endwert der Animation ab oder legt ihn fest.

Methoden

AllocateClock()	Erstellt eine Clock für diese AnimationTimeline. (Geerbt von AnimationTimeline)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Geerbt von Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Geerbt von Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Geerbt von Animatable)
CheckAccess()	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. (Geerbt von DependencyObject)
Clone()	Erstellt einen änderbaren Klon dieser ByteAnimation, indem tiefe Kopien der Werte dieses Objekts erzeugt werden. Beim Kopieren von Abhängigkeitseigenschaften kopiert diese Methode Ressourcenverweise und Datenbindungen (die aber möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte.
CloneCore(Freezable)	Definiert die Instanz als Klon (tiefe Kopie) des angegebenen Freezable-Elements, indem Basiseigenschaftenwerte (nicht animiert) verwendet werden. (Geerbt von Freezable)
CloneCurrentValue()	Erstellt einen änderbaren Klon des Timeline-Objekts, indem tiefe Kopien der aktuellen Werte dieses Objekts erzeugt werden. (Geerbt von Timeline)
CloneCurrentValueCore(Freezable)	Macht die Instanz mithilfe aktueller Eigenschaftswerte zu einem Klon (tiefe Kopie) des angegebenen Freezable-Elements, der geändert werden kann. (Geerbt von Freezable)
CoerceValue(DependencyProperty)	Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird. (Geerbt von DependencyObject)
CreateClock()	Erstellt ein neues AnimationClock-Objekt aus diesem AnimationTimeline-Objekt. (Geerbt von AnimationTimeline)
CreateClock(Boolean)	Erstellt anhand dieser Clock eine neue Timeline und gibt an, ob die neue Clock steuerbar ist. Wenn diese Timeline untergeordnete Elemente besitzt, wird eine Struktur von Uhren mit dieser Timeline als Stamm erstellt. (Geerbt von Timeline)
CreateInstance()	Initialisiert eine neue Instanz der Freezable-Klasse. (Geerbt von Freezable)
CreateInstanceCore()	Erstellt eine neue Instanz der ByteAnimation.
Equals(Object)	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Geerbt von DependencyObject)
Freeze()	Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf `true` fest. (Geerbt von Freezable)
FreezeCore(Boolean)	Legt diese Timeline als nicht änderbar fest oder bestimmt, ob diese als nicht änderbar festgelegt werden kann. (Geerbt von Timeline)
GetAnimationBaseValue(DependencyProperty)	Gibt den nicht animierten Wert der angegebenen DependencyProperty zurück. (Geerbt von Animatable)
GetAsFrozen()	Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Geerbt von Freezable)
GetAsFrozenCore(Freezable)	Macht diese Instanz zu einem Klon des angegebenen Timeline-Objekts. (Geerbt von Timeline)
GetCurrentValue(Byte, Byte, AnimationClock)	Ruft den aktuellen Wert der Animation ab. (Geerbt von ByteAnimationBase)
GetCurrentValue(Object, Object, AnimationClock)	Ruft den aktuellen Wert der Animation ab. (Geerbt von ByteAnimationBase)
GetCurrentValueAsFrozen()	Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Geerbt von Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Macht diese Instanz zu einem fixierten Klon des angegebenen Timeline-Objekts. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert. (Geerbt von Timeline)
GetCurrentValueCore(Byte, Byte, AnimationClock)	Berechnet einen Wert, der den aktuellen Wert der zu animierenden Eigenschaft gemäß der ByteAnimation darstellt.
GetHashCode()	Ruft einen Hashcode für diese DependencyObject ab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Geerbt von DependencyObject)
GetNaturalDuration(Clock)	Gibt die Länge einer einzelnen Iteration der Timeline zurück. (Geerbt von Timeline)
GetNaturalDurationCore(Clock)	Gibt die Länge einer einzelnen Iteration der AnimationTimeline zurück. (Geerbt von AnimationTimeline)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück. (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnChanged()	Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden. (Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Dieses Member unterstützt die Windows Presentation Foundation -Infrastruktur (WPF) und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Überschreibt die DependencyObject-Implementierung von OnPropertyChanged(DependencyPropertyChangedEventArgs), damit in Reaktion auf eine geänderte Abhängigkeitseigenschaft des Typs Freezable auch Changed-Handler aufgerufen werden. (Geerbt von Freezable)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist. (Geerbt von DependencyObject)
ReadPreamble()	Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird. Vererber von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Geerbt von Freezable)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist. (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 ist. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
VerifyAccess()	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
WritePostscript()	Löst das Changed-Ereignis für das Freezable-Objekt aus und ruft dessen OnChanged()-Methode auf. Klassen, die aus Freezable abgeleitet werden, sollten diese Methode am Ende jeder API aufrufen, die Klassenmember ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind. (Geerbt von Freezable)
WritePreamble()	Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird. Vererber von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Geerbt von Freezable)

Ereignisse

Changed	Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird. (Geerbt von Freezable)
Completed	Tritt auf, wenn die Wiedergabe dieser Zeitachse vollständig beendet wurde, d. h., diese nicht mehr in den aktiven Zeitraum wechselt. (Geerbt von Timeline)
CurrentGlobalSpeedInvalidated	Tritt auf wenn die Geschwindigkeit geändert wird, mit der die Zeit für die Uhr der Zeitachse verläuft. (Geerbt von Timeline)
CurrentStateInvalidated	Tritt ein, wenn die CurrentState-Eigenschaft der Clock der Zeitachse aktualisiert wird. (Geerbt von Timeline)
CurrentTimeInvalidated	Tritt ein, wenn die CurrentTime-Eigenschaft der Clock der Zeitachse aktualisiert wird. (Geerbt von Timeline)
RemoveRequested	Tritt auf, wenn die für diese Zeitachse erstellte Uhr oder eine der übergeordneten Zeitachsen entfernt wird. (Geerbt von Timeline)

Gilt für:

Freigeben über