Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
SplineColorKeyFrame, classe
System.Windows.Threading.DispatcherObject
System.Windows.DependencyObject
System.Windows.Freezable
System.Windows.Media.Animation.ColorKeyFrame
System.Windows.Media.Animation.SplineColorKeyFrame
Assembly : PresentationCore (dans PresentationCore.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
Le type SplineColorKeyFrame expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
SplineColorKeyFrame() | Initialise une nouvelle instance de la classe SplineColorKeyFrame. |
|
SplineColorKeyFrame(Color) | Initialise une nouvelle instance de la classe SplineColorKeyFrame avec la valeur de fin spécifiée. |
|
SplineColorKeyFrame(Color, KeyTime) | Initialise une nouvelle instance de la classe SplineColorKeyFrame avec la valeur de fin et la période de clé spécifiées. |
|
SplineColorKeyFrame(Color, KeyTime, KeySpline) | Initialise une nouvelle instance de la classe SplineColorKeyFrame avec la valeur de fin, la période de clé et le KeySpline spécifiés. |
| Nom | Description | |
|---|---|---|
|
CanFreeze | Obtient une valeur qui indique la possibilité ou non de rendre un objet non modifiable. (Hérité de Freezable.) |
|
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 ou pas. (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.) |
|
KeySpline | Obtient ou définit les deux points de contrôle qui définissent la progression d'animation pour cette image clé. |
|
KeyTime | Obtient ou établit l'heure à laquelle la valeur cible Value de l'image clé doit être atteinte. (Hérité de ColorKeyFrame.) |
|
Value | Obtient ou définit la valeur cible de l'image clé. (Hérité de ColorKeyFrame.) |
| Nom | Description | |
|---|---|---|
|
CheckAccess | Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.) |
|
ClearValue(DependencyProperty) | Efface la valeur de proximité 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 de proximité d'une propriété en lecture seule. La propriété à effacer est spécifiée par un 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 risquent de ne plus pouvoir se résoudre) mais pas les animations ou leurs valeurs actuelles. (Hérité de Freezable.) |
|
CloneCore | Convertit l'instance en clone (copie complète) du Freezable spécifié à l'aide des valeurs de propriétés (non-animées) de base. (Hérité de Freezable.) |
|
CloneCurrentValue | Crée un clone modifiable (copie complète) de Freezable en utilisant ses valeurs actuelles. (Hérité de Freezable.) |
|
CloneCurrentValueCore | Convertit l'instance en clone modifiable (copie complète) du Freezable spécifié à l'aide des valeurs de propriétés actuelles. (Hérité de Freezable.) |
|
CoerceValue | Force la valeur de la propriété de dépendance spécifiée. Cette opération est accomplie en appelant toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance comme 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 nouvelle instance de SplineColorKeyFrame. (Substitue Freezable.CreateInstanceCore().) |
|
Equals | Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
Freeze() | Rend l'objet actuel non modifiable et définit sa propriété IsFrozen sur true. (Hérité de Freezable.) |
|
FreezeCore | 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 | Convertit l'instance en clone figé du Freezable spécifié à l'aide des valeurs de propriétés (non-animées) de base. (Hérité de Freezable.) |
|
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 | Convertit l'instance actuelle en un clone figé du Freezable spécifié. Si l'objet comporte des propriétés de dépendance animées, leurs valeurs animées actuelles sont copiées. (Hérité de Freezable.) |
|
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.) |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
GetValue | Retourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.) |
|
InterpolateValue | Retourne la valeur interpolée d'une image clé spécifique en fonction de l'incrément de progression fourni. (Hérité de ColorKeyFrame.) |
|
InterpolateValueCore | Utilise une interpolation spline pour assurer la transition entre la valeur de l'image clé précédente et la valeur de l'image clé actuelle. (Substitue ColorKeyFrame.InterpolateValueCore(Color, Double).) |
|
InvalidateProperty | Réévalue la valeur effective pour la propriété de dépendance spécifiée (Hérité de DependencyObject.) |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
OnChanged | Appelé lors de la modification de l'objet Freezable actuel. (Hérité de Freezable.) |
|
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 conçu pour être utilisé directement à partir du code. (Hérité de Freezable.) |
|
OnPropertyChanged | Substitue l'implémentation DependencyObject de OnPropertyChanged 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 | Retourne la valeur de proximité 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 | Définit la valeur d'une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject.) |
|
SetValue(DependencyProperty, Object) | Définit la valeur de proximité 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 de proximité 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 | Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur pour la propriété de dépendance fournie. (Hérité de DependencyObject.) |
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
|
VerifyAccess | Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.) |
|
WritePostscript | Déclenche l'événement Changed pour 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 non 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 les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable.) |
| Nom | Description | |
|---|---|---|
|
IKeyFrame.Value | Obtient ou définit la valeur associée à une instance KeyTime. (Hérité de ColorKeyFrame.) |
Cette classe est utilisée dans le cadre de la collection ColorKeyFrameCollection avec un ColorAnimationUsingKeyFrames afin d'animer une valeur de la propriété Color en fonction d'un ensemble d'images clés.
Une image clé définit un segment du ColorAnimationUsingKeyFrames auquel elle appartient. Une valeur Value cible et une période de clé KeyTime sont définies pour chaque image clé. Le KeyTime spécifie l'heure à laquelle la valeur Value de l'image clé doit être atteinte. Une image clé passe de la valeur cible de l'image clé précédente à sa propre valeur cible. Elle démarre la fin de l'image clé précédente et s'achève au terme de sa propre période de clé.
Les images clé de spline telles que SplineColorKeyFrame permettent d'assurer une transition à paramètres variables entre les valeurs, transition déterminée par la propriété KeySpline. L'interpolation spline peut être utilisée pour obtenir des effets de minutage, tels que des effets d'accélération et de décélération, plus proches de la réalité.
This example shows how to animate the Color of a SolidColorBrush by using key frames.
The following example uses the ColorAnimationUsingKeyFrames class to animate the Color property of a SolidColorBrush. This animation uses three key frames in the following manner:
-
During the first two seconds, uses an instance of the LinearColorKeyFrame class to gradually change the color from green to red. Linear key frames like LinearColorKeyFrame create a smooth linear transition between values.
-
During the end of the next half second, uses an instance of the DiscreteColorKeyFrame class to quickly change the color from red to yellow. Discrete key frames like DiscreteColorKeyFrame create sudden changes between values, that is, the color change in this part of the animation occurs quickly and is not subtle.
-
During the final two seconds, uses an instance of the SplineColorKeyFrame class to change the color again—this time from yellow back to green. Spline key frames like SplineColorKeyFrame create a variable transition between values according to the values of the KeySpline property. In this example, the change in color begins slowly and speeds up exponentially toward the end of the time segment.
using System; using System.Windows; using System.Windows.Controls; using System.Windows.Shapes; using System.Windows.Media.Animation; using System.Windows.Media; namespace Microsoft.Samples.KeyFrameExamples { public class ColorAnimationUsingKeyFramesExample : Page { public ColorAnimationUsingKeyFramesExample() { Title = "BooleanAnimationUsingKeyFrames Example"; Background = Brushes.White; Margin = new Thickness(20); // Create a NameScope for this page so that // Storyboards can be used. NameScope.SetNameScope(this, new NameScope()); StackPanel myStackPanel = new StackPanel(); myStackPanel.Orientation = Orientation.Vertical; myStackPanel.HorizontalAlignment = HorizontalAlignment.Center; // Create the Border that is the target of the animation. SolidColorBrush animatedBrush = new SolidColorBrush(); animatedBrush.Color = Color.FromArgb(255, 0, 255, 0); Border myBorder = new Border(); // Set the initial color of the border to green. myBorder.BorderBrush = animatedBrush; myBorder.BorderThickness = new Thickness(28); myBorder.Padding = new Thickness(20); myStackPanel.Children.Add(myBorder); // Create a TextBlock to host inside the Border. TextBlock myTextBlock = new TextBlock(); myTextBlock.Text = "This example shows how to use the ColorAnimationUsingKeyFrames" + " to create an animation on the BorderBrush property of a Border."; myBorder.Child = myTextBlock; // Assign the Brush a name so that // it can be targeted by a Storyboard. this.RegisterName( "AnimatedBrush", animatedBrush); // Create a ColorAnimationUsingKeyFrames to // animate the BorderBrush property of the Button. ColorAnimationUsingKeyFrames colorAnimation = new ColorAnimationUsingKeyFrames(); colorAnimation.Duration = TimeSpan.FromSeconds(6); // Create brushes to use as animation values. Color redColor = new Color(); redColor = Color.FromArgb(255, 255, 0, 0); Color yellowColor = new Color(); yellowColor = Color.FromArgb(255, 255, 255, 0); Color greenColor = new Color(); greenColor = Color.FromArgb(255, 0, 255, 0); // Go from green to red in the first 2 seconds. LinearColorKeyFrame creates // a smooth, linear animation between values. colorAnimation.KeyFrames.Add( new LinearColorKeyFrame( redColor, // Target value (KeyValue) KeyTime.FromTimeSpan(TimeSpan.FromSeconds(2.0))) // KeyTime ); // In the next half second, go to yellow. DiscreteColorKeyFrame creates a // sudden jump between values. colorAnimation.KeyFrames.Add( new DiscreteColorKeyFrame( yellowColor, // Target value (KeyValue) KeyTime.FromTimeSpan(TimeSpan.FromSeconds(2.5))) // KeyTime ); // In the final 2 seconds of the animation, go from yellow back to green. SplineColorKeyFrame // creates a variable transition between values depending on the KeySpline property. In this example, // the animation starts off slow but toward the end of the time segment, it speeds up exponentially. colorAnimation.KeyFrames.Add( new SplineColorKeyFrame( greenColor, // Target value (KeyValue) KeyTime.FromTimeSpan(TimeSpan.FromSeconds(4.5)), // KeyTime new KeySpline(0.6, 0.0, 0.9, 0.0) // KeySpline ) ); // Set the animation to repeat forever. colorAnimation.RepeatBehavior = RepeatBehavior.Forever; // Set the animation to target the Color property // of the object named "AnimatedBrush". Storyboard.SetTargetName(colorAnimation, "AnimatedBrush"); Storyboard.SetTargetProperty( colorAnimation, new PropertyPath(SolidColorBrush.ColorProperty)); // Create a storyboard to apply the animation. Storyboard myStoryboard = new Storyboard(); myStoryboard.Children.Add(colorAnimation); // Start the storyboard when the Border loads. myBorder.Loaded += delegate(object sender, RoutedEventArgs e) { myStoryboard.Begin(this); }; Content = myStackPanel; } } }
<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" Title="ThicknessAnimationUsingKeyFrames Example"> <StackPanel Orientation="Vertical" HorizontalAlignment="Center"> <Border Background="#99FFFFFF" BorderThickness="28" Margin="0,60,0,20" Padding="20" > <Border.BorderBrush> <SolidColorBrush x:Name="MyAnimatedBrush" Color="Green" /> </Border.BorderBrush> <Border.Triggers> <EventTrigger RoutedEvent="Border.Loaded"> <BeginStoryboard> <Storyboard> <!-- Animate from green to red using a linear key frame, from red to yellow using a discrete key frame, and from yellow back to green with a spline key frame. This animation repeats forever. --> <ColorAnimationUsingKeyFrames Storyboard.TargetProperty="Color" Storyboard.TargetName="MyAnimatedBrush" Duration="0:0:6" FillBehavior="HoldEnd" RepeatBehavior="Forever"> <ColorAnimationUsingKeyFrames.KeyFrames> <!-- Go from green to red in the first 2 seconds. LinearColorKeyFrame creates a smooth, linear animation between values. --> <LinearColorKeyFrame Value="Red" KeyTime="0:0:2" /> <!-- In the next half second, go to yellow. DiscreteColorKeyFrame creates a sudden jump between values. --> <DiscreteColorKeyFrame Value="Yellow" KeyTime="0:0:2.5" /> <!-- In the final 2 seconds of the animation, go from yellow back to green. SplineColorKeyFrame creates a variable transition between values depending on the KeySpline property. In this example, the animation starts off slow but toward the end of the time segment, it speeds up exponentially.--> <SplineColorKeyFrame Value="Green" KeyTime="0:0:4.5" KeySpline="0.6,0.0 0.9,0.00" /> </ColorAnimationUsingKeyFrames.KeyFrames> </ColorAnimationUsingKeyFrames> </Storyboard> </BeginStoryboard> </EventTrigger> </Border.Triggers> <TextBlock> This example shows how to use the ColorAnimationUsingKeyFrames to create an animation on the BorderBrush property of a Border. </TextBlock> </Border> </StackPanel> </Page>
For the complete sample, see KeyFrame Animation Sample.
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.