Freigeben über


CompositionObject.StartAnimation Methode

Definition

Ü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

Gilt für:

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

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.

Gilt für: