KeySpline Classe

Définition

Espace de noms:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

Cette classe est utilisée par une image clé de spline pour définir la progression de l’animation.

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 IFormattable

Public Class KeySpline
Inherits Freezable
Implements IFormattable

Héritage

Object

DispatcherObject

DependencyObject

Freezable

KeySpline

Attributs

TypeConverterAttribute LocalizabilityAttribute

Implémente

IFormattable

Remarques

Pour comprendre le fonctionnement d’un KeySpline , il est utile de comprendre les courbes cubiques de Béziers. Une courbe de Bézier cubique est définie par un point de départ, un point de terminaison et deux points de contrôle. Les deux coordonnées dans le KeySpline définissent ces deux points de contrôle. Lorsque vous décrivez des splines clés, le point de début de la courbe de Bézier est toujours 0 et le point de fin est toujours 1, c’est pourquoi vous définissez uniquement les deux points de contrôle. La courbe résultante spécifie la façon dont une animation est interpolée pendant un segment de temps ; autrement dit, la courbe représente la vitesse de modification de l’attribut cible de l’animation sur le segment de temps. Pour mieux voir la relation entre la progression de l’animation et une courbe de Bézier, consultez Exemple d’animation spline clé.

Utilisation d'attributs XAML

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

Valeurs XAML

cp1X
X composant du premier point de contrôle de la courbe. Elle doit être comprise entre 0 et 1.

cp1Y
Y composant du premier point de contrôle de la courbe. Elle doit être comprise entre 0 et 1.

cp2X
X composant du deuxième point de contrôle de la courbe. Elle doit être comprise entre 0 et 1.

cp2Y
Y composant du deuxième point de contrôle de la courbe. Elle doit être comprise entre 0 et 1.

Le séparateur entre les valeurs peut être une virgule ou un ou plusieurs espaces. La convention illustrée ici de virgules entre les composants d’un point et l’espace entre les points est une convention recommandée. N’utilisez pas de virgule comme virgule décimale dans les valeurs des composants de points, même si c’est la norme dans votre culture. Les valeurs XAML sont traitées comme en-us dans tous les cas de conversion de type, et la virgule est donc interprétée comme le séparateur et non comme la virgule décimale prévue.

Constructeurs

KeySpline()	Initialise une nouvelle instance de la classe KeySpline.
KeySpline(Double, Double, Double, Double)	Initialise une nouvelle instance de la classe KeySpline avec les coordonnées spécifiées pour les points de contrôle.
KeySpline(Point, Point)	Initialise une nouvelle instance de la classe KeySpline avec les points de contrôle spécifiées.

Propriétés

CanFreeze	Obtient une valeur qui indique si l’objet peut être rendu non modifiable. (Hérité de Freezable)
ControlPoint1	Premier point de contrôle utilisé pour définir une courbe de Bézier qui décrit un KeySpline.
ControlPoint2	Deuxième point de contrôle utilisé pour définir une courbe de Bézier qui décrit un KeySpline.
DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
IsFrozen	Obtient une valeur qui indique si l’objet est actuellement modifiable. (Hérité de Freezable)
IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject)

Méthodes

CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey. (Hérité de DependencyObject)
Clone()	Crée un clone modifiable de Freezable, en créant des copies complètes des valeurs de l’objet. Lors de la copie des propriétés de dépendance de l’objet, cette méthode copie les expressions (qui peuvent ne plus se résoudre), mais pas les animations ni leurs valeurs actuelles. (Hérité de Freezable)
CloneCore(Freezable)	Convertit cette instance en copie complète de l’objet KeySpline spécifié. Pendant la copie des propriétés de dépendance, cette méthode copie les références de ressources et les liaisons de données (qui risquent toutefois de ne plus pouvoir se résoudre), mais pas les animations ni leurs valeurs actuelles.
CloneCurrentValue()	Crée un clone modifiable (copie complète) de Freezable en utilisant ses valeurs actuelles. (Hérité de Freezable)
CloneCurrentValueCore(Freezable)	Convertit cette instance en copie complète modifiable de l’objet KeySpline spécifié à l’aide des valeurs de propriété actuelles. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées.
CoerceValue(DependencyProperty)	Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant. (Hérité de DependencyObject)
CreateInstance()	Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable)
CreateInstanceCore()	Crée une instance de KeySpline.
Equals(Object)	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject)
Freeze()	Rend l’objet actif non modifiable et attribue à sa propriété IsFrozen la valeur true. (Hérité de Freezable)
FreezeCore(Boolean)	Rend l'objet Freezable non modifiable ou vérifie si celui-ci peut être rendu non modifiable ou pas. (Hérité de Freezable)
GetAsFrozen()	Crée une copie figée de Freezable, à l'aide des valeurs de propriété (non-animées) de base. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. (Hérité de Freezable)
GetAsFrozenCore(Freezable)	Convertit cette instance en un clone de l’objet KeySpline spécifié.
GetCurrentValueAsFrozen()	Crée une copie figée de Freezable à l'aide des valeurs de propriété actuelles. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. (Hérité de Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Convertit cette instance en clone figé du KeySpline spécifié. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées.
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject)
GetSplineProgress(Double)	Calcule la progression de spline à partir d’une progression linéaire fournie.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)	Réévalue la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnChanged()	Appelé lorsque l’objet KeySpline actuel est modifié.
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantit que les pointeurs de contexte appropriés sont établis pour un membre de données de type DependencyObjectType qui vient juste d'être défini. (Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code. (Hérité de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Substitue l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) pour appeler également tous les gestionnaires Changed en réponse à une propriété de dépendance variable de type Freezable. (Hérité de Freezable)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject)
ReadPreamble()	Garantit que Freezable est accessible à partir d'un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API lisant les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
ToString()	Crée une représentation sous forme de chaîne de cette instance de KeySpline basée sur la culture actuelle.
ToString(IFormatProvider)	Crée une représentation sous forme de chaîne de ce KeySpline basée sur le IFormatProvider fourni.
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)
WritePostscript()	Déclenche l’événement Changed pour le Freezable et appelle sa méthode OnChanged(). Les classes qui dérivent de Freezable doivent appeler cette méthode à la fin de toute API qui modifie des membres de classe qui ne sont pas stockés en tant que propriétés de dépendance. (Hérité de Freezable)
WritePreamble()	Vérifie que le Freezable n'est pas figé et que son accès s'effectue à partir d'un contexte de thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API écrivant dans les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable)

Événements

Changed

Se produit lorsque Freezable ou un objet qu'il contient est modifié. (Hérité de Freezable)

Implémentations d’interfaces explicites

IFormattable.ToString(String, IFormatProvider)

Met en forme la valeur de l’instance actuelle en utilisant le format spécifié.

Voir aussi

• Animation de spline clé, exemple