KeySpline 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.
Diese Klasse wird von einem Spline-Keyframe zum Definieren des Animationsstatus verwendet.
public ref class KeySpline : System::Windows::Freezable, IFormattable[System.ComponentModel.TypeConverter(typeof(System.Windows.KeySplineConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public class KeySpline : System.Windows.Freezable, IFormattable[<System.ComponentModel.TypeConverter(typeof(System.Windows.KeySplineConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type KeySpline = class
inherit Freezable
interface IFormattablePublic Class KeySpline
Inherits Freezable
Implements IFormattable- Vererbung
- Attribute
- Implementiert
Hinweise
Um zu verstehen, wie ein KeySpline funktioniert, ist es hilfreich, kubische Bézierkurven zu verstehen. Eine kubische Zierkurve wird durch einen Anfangspunkt, einen Endpunkt und zwei Kontrollpunkte definiert. Die beiden Koordinaten in definieren KeySpline diese beiden Kontrollpunkte. Beim Beschreiben von Schlüsselsplines ist der Startpunkt der Bézierkurve immer 0, und der Endpunkt ist immer 1, weshalb Sie nur die beiden Kontrollpunkte definieren. Die resultierende Kurve gibt an, wie eine Animation während eines Zeitsegments interpoliert wird. Das heißt, die Kurve stellt die Änderungsrate im Zielattribute der Animation im Zeitsegment dar. Informationen zum besseren Anzeigen der Beziehung zwischen dem Animationsfortschritt und einer Bézierkurve finden Sie unter Beispiel für Key Spline-Animationen.
Verwendung von XAML-Attributen
<object property="cp1X,cp1Y cp2X,cp2Y"/>
XAML-Werte
cp1X
X Komponente des ersten Steuerungspunkts der Kurve. Der Wert muss zwischen 0 und 1 liegen.
cp1Y
Y Komponente des ersten Steuerungspunkts der Kurve. Der Wert muss zwischen 0 und 1 liegen.
cp2X
X Komponente des zweiten Steuerungspunkts der Kurve. Der Wert muss zwischen 0 und 1 liegen.
cp2Y
Y Komponente des zweiten Steuerungspunkts der Kurve. Der Wert muss zwischen 0 und 1 liegen.
Das Trennzeichen zwischen Werten kann entweder Kommas oder mindestens ein Leerzeichen sein. Die hier gezeigte Konvention von Kommas zwischen Komponenten eines Punkts und Abstand zwischen Punkten ist eine empfohlene Konvention. Verwenden Sie kein Komma als Dezimalpunkt innerhalb der Werte von Punktkomponenten, auch wenn dies die Norm in Ihrer Kultur ist. XAML-Werte werden in allen Typkonvertierungsfällen als en-us behandelt, und das Komma wird daher als Trennzeichen und nicht als beabsichtigtes Dezimalzeichen interpretiert.
Konstruktoren
| KeySpline() |
Initialisiert eine neue Instanz der KeySpline-Klasse. |
| KeySpline(Double, Double, Double, Double) |
Initialisiert eine neue Instanz der KeySpline-Klasse mit den angegebenen Koordinaten für die Kontrollpunkte. |
| KeySpline(Point, Point) |
Initialisiert eine neue Instanz der KeySpline-Klasse mit den angegebenen Kontrollpunkten. |
Eigenschaften
| CanFreeze |
Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann. (Geerbt von Freezable) |
| ControlPoint1 |
Der erste Kontrollpunkt, der zum Definieren einer Bézierkurve verwendet wird, die eine KeySpline beschreibt. |
| ControlPoint2 |
Der zweite Kontrollpunkt, der zum Definieren einer Bézierkurve verwendet wird, die eine KeySplinebeschreibt. |
| DependencyObjectType |
Ruft die ab, die DependencyObjectType den CLR-Typ dieser instance umschließt. (Geerbt von DependencyObject) |
| Dispatcher |
Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject) |
| 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) |
Methoden
| 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 des Freezable-Objekts, indem tiefe Kopien der Werte des Objekts erstellt werden. Beim Kopieren der Abhängigkeitseigenschaften des Objekts kopiert diese Methode Ausdrücke (die möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte. (Geerbt von Freezable) |
| CloneCore(Freezable) |
Macht diese Instanz zu einer tiefen Kopie der angegebenen KeySpline. 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. |
| CloneCurrentValue() |
Erstellt einen änderbaren Klon (tiefe Kopie) von Freezable mit den aktuellen Werten. (Geerbt von Freezable) |
| CloneCurrentValueCore(Freezable) |
Macht diese Instanz mithilfe aktueller Eigenschaftswerte zu einer tiefen Kopie der angegebenen KeySpline, die geändert werden kann. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert. |
| 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) |
| CreateInstance() |
Initialisiert eine neue Instanz der Freezable-Klasse. (Geerbt von Freezable) |
| CreateInstanceCore() |
Erstellt eine neue Instanz von KeySpline. |
| 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 |
| FreezeCore(Boolean) |
Legt das Freezable-Objekt als nicht änderbar fest oder überprüft, ob es als nicht änderbar festgelegt werden kann. (Geerbt von Freezable) |
| 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 KeySpline-Objekts. |
| 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 KeySpline-Objekts. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert. |
| 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) |
| GetSplineProgress(Double) |
Berechnet den Splinestatus anhand eines angegebenen linearen Status. |
| 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 KeySpline-Objekt geändert wird. |
| 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 WPF-Infrastruktur (Windows Presentation Foundation) 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() |
Erstellt eine Zeichenfolgendarstellung dieser Instanz von KeySpline auf der Grundlage der aktuellen Kultur. |
| ToString(IFormatProvider) |
Erstellt auf der Grundlage des angegebenen KeySpline eine Zeichenfolgendarstellung dieser IFormatProvider. |
| 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) |
Explizite Schnittstellenimplementierungen
| IFormattable.ToString(String, IFormatProvider) |
Formatiert den Wert der aktuellen Instanz mit dem angegebenen Format. |
