SplineColorKeyFrame Classe

Définition

Espace de noms:

Windows.UI.Xaml.Media.Animation

Anime à partir de la valeur Color de l’image clé précédente vers sa propre valeur à l’aide de l’interpolation splined.

public ref class SplineColorKeyFrame sealed : ColorKeyFrame

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class SplineColorKeyFrame final : ColorKeyFrame

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class SplineColorKeyFrame : ColorKeyFrame

Public NotInheritable Class SplineColorKeyFrame
Inherits ColorKeyFrame

<SplineColorKeyFrame .../>

Héritage

Object Platform::Object IInspectable DependencyObject ColorKeyFrame SplineColorKeyFrame

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple XAML utilise la classe ColorAnimationUsingKeyFrames pour animer la propriété Background d’un StackPanel. Cette animation utilise trois images clés de la manière suivante :

1. Au cours des deux premières secondes, LinearColorKeyFrame change progressivement la couleur du vert au rouge. Les images clés linéaires comme LinearColorKeyFrame créent une transition linéaire fluide entre les valeurs.
2. À la fin de la demi-seconde suivante, DiscreteColorKeyFrame change rapidement la couleur du rouge au jaune. Les images clés discrètes telles que DiscreteColorKeyFrame créent des changements soudains entre les valeurs ; l’animation se produit rapidement et n’a aucune interpolation entre les valeurs.
3. Au cours des deux dernières secondes, SplineColorKeyFrame change à nouveau la couleur, cette fois du jaune au vert. Les images clés spline comme SplineColorKeyFrame créent une transition de variable entre les valeurs en fonction des valeurs de la propriété KeySpline . Un KeySpline permet de modifier la relation temps/valeur pendant la durée de l’animation pour qu’elle soit non linéaire, et en particulier la relation peut être une courbe qui serait difficile à produire avec des images clés individuelles. Dans cet exemple, le changement de couleur commence lentement, puis accélère de façon exponentielle jusqu’à la fin du segment temporel.

<StackPanel x:Name="myStackPanel" Background="Red"
Loaded="Start_Animation">
    <StackPanel.Resources>
        <Storyboard x:Name="colorStoryboard">

            <ColorAnimationUsingKeyFrames Storyboard.TargetName="myStackPanel" 
      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)">
                
                <!-- Go from green to red in the first 2 seconds. LinearColorKeyFrame creates
                a smooth, linear animation between values. -->
                <LinearColorKeyFrame Value="Blue" KeyTime="00:00:02" />

                <!-- In the next half second, go to yellow. DiscreteColorKeyFrame creates a 
                sudden jump between values. -->
                <DiscreteColorKeyFrame Value="Yellow" KeyTime="00:00: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="00:00:4.5" KeySpline="0.6,0.0 0.9,0.00" />

            </ColorAnimationUsingKeyFrames>
        </Storyboard>
    </StackPanel.Resources>
</StackPanel>

// Start the animation when the object loads
private void Start_Animation(object sender, RoutedEventArgs e)
{
    colorStoryboard.Begin();
}

' Start the animation when the object loads
Private Sub Start_Animation(ByVal sender As Object, ByVal e As EventArgs)
    colorStoryboard.Begin()
End Sub

Remarques

Les animations par images clés autorisent plusieurs valeurs cibles pouvant être atteintes à divers points de la chronologie. En d’autres termes chaque image clé peut spécifier une valeur intermédiaire différente, et la dernière image clé atteinte correspond à la valeur finale de l’animation. En précisant plusieurs valeurs à animer, il vous est alors possible d’effectuer des animations plus complexes. Vous pouvez combiner des images clés discrètes, linéaires et spline dans la même collection d’images clés.

Pour plus d’informations sur l’utilisation des animations d’images clés, consultez Animations d’images clés et animations de fonction d’accélération.

Constructeurs

SplineColorKeyFrame()

Initialise une nouvelle instance de la classe SplineColorKeyFrame.

Propriétés

Dispatcher	Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une fonctionnalité qui peut accéder à DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur. (Hérité de DependencyObject)
KeySpline	Obtient ou définit les deux points de contrôle qui définissent la progression de l’animation pour cette image clé.
KeySplineProperty	Identifie la propriété de dépendance KeySpline .
KeyTime	Obtient ou définit l’heure à laquelle la valeur cible de la trame clé doit être atteinte. (Hérité de ColorKeyFrame)
Value	Obtient ou définit la valeur cible de l’image clé. (Hérité de ColorKeyFrame)

Méthodes

ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Retourne toute valeur de base établie pour une propriété de dépendance, qui s’appliquerait dans les cas où une animation n’est pas active. (Hérité de DependencyObject)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un DependencyObject. (Hérité de DependencyObject)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject)

Voir aussi

• ColorKeyFrame
• ColorAnimationUsingKeyFrames
• ColorKeyFrameCollection
• KeyTime
• Value
• Animations dans une table de montage séquentiel
• Animations par images clés et animations de fonctions d’accélération