KeySpline Klasse

Definition

Diese Klasse wird von einem Spline-Keyframe zum Definieren des Animationsstatus verwendet.This class is used by a spline key frame to define animation progress.

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
type KeySpline = class
    inherit Freezable
    interface IFormattable
Public Class KeySpline
Inherits Freezable
Implements IFormattable
Vererbung
Attribute
Implementiert

Hinweise

Um zu verstehen, KeySpline wie ein funktioniert, ist es hilfreich, kubische Bezier-Kurven zu verstehen.To understand how a KeySpline works, it is helpful to understand cubic Bezier curves. Eine kubische Bezier-Kurve wird durch einen Startpunkt, einen Endpunkt und zwei Kontrollpunkte definiert.A cubic Bezier curve is defined by a start point, an end point, and two control points. Die beiden Koordinaten in KeySpline definieren diese beiden Steuerpunkte.The two coordinates in the KeySpline defines those two control points. Wenn Sie Schlüssel-Splines beschreiben, ist der Startpunkt der Bezier-Kurve immer 0, und der Endpunkt ist immer 1. aus diesem Grund definieren Sie nur die beiden Kontrollpunkte.When describing key splines, the start point of the Bezier curve is always 0, and the end point is always 1, which is why you define only the two control points. Die resultierende Kurve gibt an, wie eine Animation während eines Zeit Segments interpoliert wird. Das heißt, die Kurve stellt die Änderungs Rate im Ziel Attribut der Animation im Zeitsegment dar.The resulting curve specifies how an animation is interpolated during a time segment; that is, the curve represents the rate of change in the animation's target attribute over the time segment. Informationen zur besseren Anzeige der Beziehung zwischen Animations Fortschritt und einer Bezier-Kurve finden Sie unter Beispiel für eine KeySpline-Animation.To better see the relationship between animation progress and a Bezier curve, see Key Spline Animation Sample.

Verwendung von XAML-AttributenXAML Attribute Usage

<object property="cp1X,cp1Y cp2X,cp2Y"/>  

XAML-WerteXAML Values

cp1Xcp1X
XKomponente des ersten Kontroll Punkts der Kurve.X component of the curve's first control point. Der Wert muss zwischen 0 und 1 liegen.The value must be between 0 and 1.

cp1Ycp1Y
YKomponente des ersten Kontroll Punkts der Kurve.Y component of the curve's first control point. Der Wert muss zwischen 0 und 1 liegen.The value must be between 0 and 1.

cp2Xcp2X
XKomponente des zweiten Kontroll Punkts der Kurve.X component of the curve's second control point. Der Wert muss zwischen 0 und 1 liegen.The value must be between 0 and 1.

cp2Ycp2Y
YKomponente des zweiten Kontroll Punkts der Kurve.Y component of the curve's second control point. Der Wert muss zwischen 0 und 1 liegen.The value must be between 0 and 1.

Das Trennzeichen zwischen den Werten kann entweder ein Komma oder ein oder mehrere Leerzeichen sein.The separator between values may be either comma or one or more spaces. Die hier gezeigte Konvention der Kommas zwischen Komponenten eines Punkts und eines Leerraums zwischen Punkten ist eine empfohlene Konvention.The convention shown here of commas between components of a point and space between points is a recommended convention. Verwenden Sie kein Komma als Dezimaltrennzeichen innerhalb der Werte von Punkt Komponenten, auch wenn dies die Norm in ihrer Kultur ist.Do not use a comma as the decimal point within the values of point components, even if that is the norm in your culture. XAML-Werte werden in allen Typkonvertierungs Fällen als en-US behandelt, und das Komma wird daher als Trennzeichen und nicht als beabsichtigter Dezimaltrennzeichen interpretiert.XAML values are treated as en-us in all type conversion cases, and the comma is thus interpreted as the separator and not as the intended decimal point.

Konstruktoren

KeySpline()

Initialisiert eine neue Instanz der KeySpline-Klasse.Initializes a new instance of the KeySpline class.

KeySpline(Double, Double, Double, Double)

Initialisiert eine neue Instanz der KeySpline-Klasse mit den angegebenen Koordinaten für die Kontrollpunkte.Initializes a new instance of the KeySpline class with the specified coordinates for the control points.

KeySpline(Point, Point)

Initialisiert eine neue Instanz der KeySpline-Klasse mit den angegebenen Kontrollpunkten.Initializes a new instance of the KeySpline class with the specified control points.

Eigenschaften

CanFreeze

Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann.Gets a value that indicates whether the object can be made unmodifiable.

(Geerbt von Freezable)
ControlPoint1

Der erste Kontrollpunkt, der zum Definieren einer Bézierkurve verwendet wird, die eine KeySpline beschreibt.The first control point used to define a Bezier curve that describes a KeySpline.

ControlPoint2

Der zweite Kontrollpunkt, der zum Definieren einer Bézierkurve verwendet wird, die eine KeySpline beschreibt.The second control point used to define a Bezier curve that describes a KeySpline.

DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Geerbt von DependencyObject)
Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
IsFrozen

Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann.Gets a value that indicates whether the object is currently modifiable.

(Geerbt von Freezable)
IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(Geerbt von DependencyObject)

Methoden

CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Geerbt von DependencyObject)
Clone()

Erstellt einen änderbaren Klon des Freezable-Objekts, indem tiefe Kopien der Werte des Objekts erstellt werden.Creates a modifiable clone of the Freezable, making deep copies of the object's values. 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.When copying the object's dependency properties, this method copies expressions (which might no longer resolve) but not animations or their current values.

(Geerbt von Freezable)
CloneCore(Freezable)

Macht diese Instanz zu einer tiefen Kopie der angegebenen KeySpline.Makes this instance a deep copy of the specified 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.When copying dependency properties, this method copies resource references and data bindings (but they might no longer resolve) but not animations or their current values.

CloneCurrentValue()

Erstellt einen änderbaren Klon (tiefe Kopie) von Freezable mit den aktuellen Werten.Creates a modifiable clone (deep copy) of the Freezable using its current values.

(Geerbt von Freezable)
CloneCurrentValueCore(Freezable)

Macht diese Instanz mithilfe aktueller Eigenschaftswerte zu einer tiefen Kopie der angegebenen KeySpline, die geändert werden kann.Makes this instance a modifiable deep copy of the specified KeySpline using current property values. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert.Resource references, data bindings, and animations are not copied, but their current values are.

CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Geerbt von DependencyObject)
CreateInstance()

Initialisiert eine neue Instanz der Freezable-Klasse.Initializes a new instance of the Freezable class.

(Geerbt von Freezable)
CreateInstanceCore()

Erstellt eine neue Instanz von KeySpline.Creates a new instance of KeySpline.

Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Geerbt von DependencyObject)
Freeze()

Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf true fest.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Geerbt von Freezable)
FreezeCore(Boolean)

Legt das Freezable-Objekt als nicht änderbar fest oder überprüft, ob es als nicht änderbar festgelegt werden kann.Makes the Freezable object unmodifiable or tests whether it can be made unmodifiable.

(Geerbt von Freezable)
GetAsFrozen()

Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert).Creates a frozen copy of the Freezable, using base (non-animated) property values. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Geerbt von Freezable)
GetAsFrozenCore(Freezable)

Macht diese Instanz zu einem Klon des angegebenen KeySpline-Objekts.Makes this instance a clone of the specified KeySpline object.

GetCurrentValueAsFrozen()

Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten.Creates a frozen copy of the Freezable using current property values. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Geerbt von Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Legt diese Instanz als fixierten Klon der angegebenen KeySpline fest.Makes this instance a frozen clone of the specified KeySpline. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert.Resource references, data bindings, and animations are not copied, but their current values are.

GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.Gets a hash code for this DependencyObject.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Geerbt von DependencyObject)
GetSplineProgress(Double)

Berechnet den Splinestatus anhand eines angegebenen linearen Status.Calculates spline progress from a supplied linear progress.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnChanged()

Wird aufgerufen, wenn das aktuelle KeySpline-Objekt geändert wird.Called when the current KeySpline object is modified.

OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Geerbt von Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Dieser Member unterstützt die Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(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.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Geerbt von Freezable)
ReadLocalValue(DependencyProperty)

Gibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück.Returns the local value of a dependency property, if it exists.

(Geerbt von DependencyObject)
ReadPreamble()

Stellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird.Ensures that the Freezable is being accessed from a valid thread. Vererber von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Geerbt von Freezable)
SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Geerbt von DependencyObject)
ToString()

Erstellt eine Zeichenfolgendarstellung dieser Instanz von KeySpline auf der Grundlage der aktuellen Kultur.Creates a string representation of this instance of KeySpline based on the current culture.

ToString(IFormatProvider)

Erstellt auf der Grundlage des angegebenen KeySpline eine Zeichenfolgendarstellung dieser IFormatProvider.Creates a string representation of this KeySpline based on the supplied IFormatProvider.

VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
WritePostscript()

Löst das Changed-Ereignis für das Freezable-Objekt aus und ruft dessen OnChanged()-Methode auf.Raises the Changed event for the Freezable and invokes its OnChanged() method. Klassen, die aus Freezable abgeleitet werden, sollten diese Methode am Ende jeder API aufrufen, die Klassenmember ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Geerbt von Freezable)
WritePreamble()

Stellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Vererber von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Geerbt von Freezable)

Ereignisse

Changed

Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird.Occurs when the Freezable or an object it contains is modified.

(Geerbt von Freezable)

Explizite Schnittstellenimplementierungen

IFormattable.ToString(String, IFormatProvider)

Formatiert den Wert der aktuellen Instanz unter Verwendung des angegebenen Formats.Formats the value of the current instance using the specified format.

Gilt für:

Siehe auch