CompositionObject.StartAnimation Método

Definição

Namespace:

Windows.UI.Composition

Sobrecargas

StartAnimation(String, CompositionAnimation)	Conecta uma animação com a propriedade especificada do objeto e inicia a animação.
StartAnimation(String, CompositionAnimation, AnimationController)	Conecta uma animação com a propriedade especificada do objeto e inicia a animação.

StartAnimation(String, CompositionAnimation)

Conecta uma animação com a propriedade especificada do objeto e inicia a animação.

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)

Parâmetros

propertyName

String

Platform::String

winrt::hstring

A propriedade à qual associar a animação.

animation

CompositionAnimation

A animação a ser associada à propriedade especificada.

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v2.0)

Exemplos

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

Comentários

Se uma animação já estiver associada à propriedade de um objeto quando StartAnimation for chamada, a animação aplicada anterior será desconectada e a nova animação será atribuída. Da mesma forma, definir a propriedade diretamente fará com que a animação anterior seja desconectada e o novo valor da propriedade entrará em vigor.

A tabela a seguir mostra a lista de propriedades animáveis:

Objeto	Nome da propriedade	Tipo de propriedade
Visual	AnchorPoint	Vector2
	CenterPoint	Vector3
	Deslocamento	Vector3
	Opacidade	Escalar
	Orientation	Vector4
	RotationAngle	Escalar
	RotationAxis	Vector3
	Tamanho	Vector2
	TransformMatrix	Matrix4x4
InsetClip	BottomInset	Escalar
	LeftInset	Escalar
	RightInset	Escalar
	TopInset	Escalar
CompositionColorBrush	Cor	Windows.UI.Color
CompositionPropertySet	Conjunto de propriedades especificadas pelo desenvolvedor.

Além disso, as propriedades de alguns efeitos no objeto CompositionEffectBrush podem ser animadas:

Nome do Efeito	Nome da propriedade	Tipo de propriedade
SaturationEffect	Saturação	Escalar
ColorSourceEffect	Cor	Vector4
AritmeticComposite	Deslocamento	Escalar
	Source1Amount	Escalar
	Source2Amount	Escalar
	MultiplyAmount	Escalar
Transform2D	TransformMatrix	Matrix3x2
ContrastEffect	Contraste	Float
ExposureEffect	Exposição	Float
HueRotationEffect	Ângulo	Float
SepiaEffect	Intensidade	Float
TemperatureAndTintEffect	Temperatura	Float
	Tonalidade	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)

Conecta uma animação com a propriedade especificada do objeto e inicia a animação.

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)

Parâmetros

propertyName

String

Platform::String

winrt::hstring

A propriedade à qual associar a animação.

animation

CompositionAnimation

A animação a ser associada à propriedade especificada.

animationController

AnimationController

O controlador de animação a ser associado à animação.

Atributos

OverloadAttribute

Requisitos do Windows

Família de dispositivos	Windows 11 Insider Preview (introduzida na 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v15.0)

Comentários

O animationController parâmetro permite associar várias animações à propriedade Progress de um único controlador, o que requer menos objetos ExpressionAnimation do que associar várias propriedades do Progress animador a uma propriedade CompositionObject.