CompositionObject.StartAnimation Methode

Definition

Namespace:

Windows.UI.Composition

Überlädt

StartAnimation(String, CompositionAnimation)	Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation.
StartAnimation(String, CompositionAnimation, AnimationController)	Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation.

StartAnimation(String, CompositionAnimation)

Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die 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)

Parameter

propertyName

String

Platform::String

winrt::hstring

Die Eigenschaft, der die Animation zugeordnet werden soll.

animation

CompositionAnimation

Die Animation, die der angegebenen Eigenschaft zugeordnet werden soll.

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v2.0)

Beispiele

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); 
} 

Hinweise

Wenn eine Animation bereits an die Eigenschaft eines Objekts gebunden ist, wenn StartAnimation aufgerufen wird, wird die vorherige angewendete Animation getrennt, und die neue Animation wird zugewiesen. Ebenso führt das direkte Festlegen der Eigenschaft dazu, dass die vorherige Animation getrennt wird, und der neue Eigenschaftswert wird wirksam.

Die folgende Tabelle zeigt die Liste der animatable-Eigenschaften:

Object	Eigenschaftsname	Eigenschaftstyp
Visuelles Element	AnchorPoint	Vector2
	CenterPoint	Vector3
	Offset	Vector3
	Deckkraft	Skalar
	Ausrichtung	Vector4
	RotationAngle	Skalar
	RotationAxis	Vector3
	Größe	Vector2
	TransformMatrix	Matrix4x4
InsetClip	BottomInset	Skalar
	LeftInset	Skalar
	RightInset	Skalar
	TopInset	Skalar
CompositionColorBrush	Farbe	Windows.UI.Color
CompositionPropertySet	Vom Entwickler angegebene Eigenschaftsgruppe.

Darüber hinaus können Eigenschaften einiger Effekte unter dem CompositionEffectBrush-Objekt animiert werden:

Effektname	Eigenschaftsname	Eigenschaftstyp
SaturationEffect	Sättigung	Skalar
ColorSourceEffect	Color	Vector4
ArithmeticComposite	Offset	Skalar
	Source1Amount	Skalar
	Source2Amount	Skalar
	MultiplyAmount	Skalar
Transform2D	TransformMatrix	Matrix3x2
ContrastEffect	Vergleichen Sie	Float
ExposureEffect	Belichtung	Float
HueRotationEffect	Angle	Float
SepiaEffect	Intensität	Float
TemperatureAndTintEffect	Temperatur	Float
	Farbton	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)

Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die 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)

Parameter

propertyName

String

Platform::String

winrt::hstring

Die Eigenschaft, der die Animation zugeordnet werden soll.

animation

CompositionAnimation

Die Animation, die der angegebenen Eigenschaft zugeordnet werden soll.

animationController

AnimationController

Der Animationscontroller, der der Animation zugeordnet werden soll.

Attribute

OverloadAttribute

Windows-Anforderungen

Gerätefamilie	Windows 11 Insider Preview (eingeführt in 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v15.0)

Hinweise

Mit animationController dem Parameter können Sie mehrere Animationen an die Progress-Eigenschaft eines einzelnen Controllers binden, die weniger ExpressionAnimation-Objekte erfordert, als die Eigenschaften mehrerer Animatoren Progress an eine CompositionObject-Eigenschaft zu binden.