CompositionObject.StartAnimation Méthode

Définition

Espace de noms:

Windows.UI.Composition

Surcharges

StartAnimation(String, CompositionAnimation)	Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.
StartAnimation(String, CompositionAnimation, AnimationController)	Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.

StartAnimation(String, CompositionAnimation)

Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.

public:
 virtual void StartAnimation(Platform::String ^ propertyName, CompositionAnimation ^ animation) = StartAnimation;

void StartAnimation(winrt::hstring const& propertyName, CompositionAnimation const& animation);

public void StartAnimation(string propertyName, CompositionAnimation animation);

function startAnimation(propertyName, animation)

Public Sub StartAnimation (propertyName As String, animation As CompositionAnimation)

Paramètres

propertyName

String

Platform::String

winrt::hstring

Propriété à laquelle associer l’animation.

animation

CompositionAnimation

Animation à associer à la propriété spécifiée.

Configuration requise pour Windows

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

Exemples

void AnimatingVisualOffset(Visual targetVisual) 
{ 
    var animation = _compositor.CreateVector3KeyFrameAnimation(); 

    // 
    // Define specific easing functions. 
    // 


    var linear = _compositor.CreateLinearEasingFunction(); 

    var easeIn = _compositor.CreateCubicBezierEasingFunction( 
            new Vector2(0.5f, 0.0f), new Vector2(1.0f, 1.0f)); 

    var easeOut = _compositor.CreateCubicBezierEasingFunction( 
            new Vector2(0.0f, 0.0f), new Vector2(0.5f, 1.0f)); 

    // 
    // Add a set of key frames to describe how the Offset should change over time.   
    // 

    animation.InsertKeyFrame(0.00f, new Vector3(100.0f, 100.0f, 0.0f)); 
    animation.InsertKeyFrame(0.25f, new Vector3(300.0f, 100.0f, 0.0f), easeIn); 
    animation.InsertKeyFrame(0.50f, new Vector3(300.0f, 300.0f, 0.0f), linear); 
    animation.InsertKeyFrame(0.75f, new Vector3(100.0f, 300.0f, 0.0f), linear); 
    animation.InsertKeyFrame(1.00f, new Vector3(100.0f, 100.0f, 0.0f), easeOut); 

    // 
    // The animation curve defined by the key frames will scale to match the duration. 
    // 

    animation.Duration = TimeSpan.FromMilliseconds(4000); 

    targetVisual.StartAnimation("Offset", animation); 
} 

Remarques

Si une animation est déjà liée à la propriété d’un objet lors de l’appel de StartAnimation, l’animation appliquée précédente est déconnectée et la nouvelle animation est affectée. De même, la définition directe de la propriété entraîne la déconnexion de l’animation précédente et la nouvelle valeur de propriété prend effet.

Le tableau suivant présente la liste des propriétés animatables :

Object	Nom de la propriété	Type de propriété
Visuels	AnchorPoint	Vector2
	CenterPoint	Vector3
	Offset	Vector3
	Opacity	Scalaire
	Orientation	Vector4
	RotationAngle	Scalaire
	RotationAxis	Vector3
	Taille	Vector2
	TransformMatrix	Matrix4x4
InsetClip	BottomInset	Scalaire
	LeftInset	Scalaire
	RightInset	Scalaire
	TopInset	Scalaire
CompositionColorBrush	Color	Windows.UI.Color
CompositionPropertySet	Ensemble de propriétés spécifiées par le développeur.

En outre, les propriétés de certains effets sous l’objet CompositionEffectBrush peuvent être animées :

Nom de l’effet	Nom de la propriété	Type de propriété
SaturationEffect	Saturation	Scalaire
ColorSourceEffect	Color	Vector4
ArithmétiqueComposite	Offset	Scalaire
	Source1Amount	Scalaire
	Source2Amount	Scalaire
	MultiplyAmount	Scalaire
Transform2d	TransformMatrix	Matrix3x2
ContrastEffect	Contraste	Float
ExposureEffect	Exposition :	Float
HueRotationEffect	Angle	Float
SepiaEffect	Intensité	Float
TemperatureAndTintEffect	Température	Float
	Teinte	Float
GammaTransferEffect	RedAmplitude	Float
	RedExponent	Float
	RedOffset	Float
	GreenAmplitude	Float
	GreenExponent	Float
	GreenOffset	Float
	BlueAmplitude	Float
	BlueExponent	Float
	BlueOffset	Float
	AlphaAmplitude	Float
	AlphaExponent	Float
	AlphaOffset	Float

StartAnimation(String, CompositionAnimation, AnimationController)

Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation.

public:
 virtual void StartAnimation(Platform::String ^ propertyName, CompositionAnimation ^ animation, AnimationController ^ animationController) = StartAnimation;

/// [Windows.Foundation.Metadata.Overload("StartAnimationWithController")]
void StartAnimation(winrt::hstring const& propertyName, CompositionAnimation const& animation, AnimationController const& animationController);

[Windows.Foundation.Metadata.Overload("StartAnimationWithController")]
public void StartAnimation(string propertyName, CompositionAnimation animation, AnimationController animationController);

function startAnimation(propertyName, animation, animationController)

Public Sub StartAnimation (propertyName As String, animation As CompositionAnimation, animationController As AnimationController)

Paramètres

propertyName

String

Platform::String

winrt::hstring

Propriété à laquelle associer l’animation.

animation

CompositionAnimation

Animation à associer à la propriété spécifiée.

animationController

AnimationController

Contrôleur d’animation à associer à l’animation.

Attributs

OverloadAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 11 Insider Preview (introduit dans 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v15.0)

Remarques

Le animationController paramètre vous permet de lier plusieurs animations à la propriété Progress d’un contrôleur unique, ce qui nécessite moins d’objets ExpressionAnimation que la liaison des propriétés de Progress plusieurs animateurs à une propriété CompositionObject.