Vector3KeyFrameAnimation 类

定义

命名空间:

Windows.UI.Composition

一种基于时间的动画，该动画以具有一个或多个关键帧的任何基于 Vector3 的属性为目标。

public ref class Vector3KeyFrameAnimation sealed : KeyFrameAnimation

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
class Vector3KeyFrameAnimation final : KeyFrameAnimation

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
public sealed class Vector3KeyFrameAnimation : KeyFrameAnimation

Public NotInheritable Class Vector3KeyFrameAnimation
Inherits KeyFrameAnimation

继承

Object Platform::Object IInspectable CompositionObject CompositionAnimation KeyFrameAnimation Vector3KeyFrameAnimation

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

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

注解

使用 CompostionObject.StartAnimation 和 CompostionObject.StopAnimation 方法来启动和停止动画。

通过调用 CompostionObject.StartAnimation 并指定属性名称和动画，动画与对象的 属性相关联。 有关可进行动画处理的属性的列表，请参阅 CompostionObject.StartAnimation 的备注部分。

属性

Comment	要与 CompositionObject 关联的字符串。 (继承自 CompositionObject)
Compositor	用于创建此 CompositionObject 的 Compositor。 (继承自 CompositionObject)
DelayBehavior	关键帧动画的延迟行为。 (继承自 KeyFrameAnimation)
DelayTime	在调用 CompositionObject.StartAnimation 后动画开始前的延迟。 (继承自 KeyFrameAnimation)
Direction	动画的播放方向。 Direction 属性允许在动画的 IterationCount 大于 1 时，从开始到结束、从结束到开始或从结束到开始之间交替来驱动动画。 这提供了一种自定义动画定义的简单方法。 (继承自 KeyFrameAnimation)
Dispatcher	CompositionObject 的调度程序。 (继承自 CompositionObject)
DispatcherQueue	获取 CompostionObject 的 DispatcherQueue 。 (继承自 CompositionObject)
Duration	动画的持续时间。 (继承自 KeyFrameAnimation)
ImplicitAnimations	附加到此 对象的隐式动画的集合。 (继承自 CompositionObject)
InitialValueExpressions	获取动画的初始值。 (继承自 CompositionAnimation)
IterationBehavior	关键帧动画的迭代行为。 (继承自 KeyFrameAnimation)
IterationCount	重复关键帧动画的次数。 (继承自 KeyFrameAnimation)
KeyFrameCount	KeyFrameAnimation 中的关键帧数。 (继承自 KeyFrameAnimation)
Properties	与 CompositionObject 关联的属性的集合。 (继承自 CompositionObject)
StopBehavior	指定在调用 StopAnimation 时如何设置属性值。 (继承自 KeyFrameAnimation)
Target	动画的目标。 (继承自 CompositionAnimation)

方法

ClearAllParameters()	清除动画的所有参数。 (继承自 CompositionAnimation)
ClearParameter(String)	从动画中清除参数。 (继承自 CompositionAnimation)
Close()	关闭 CompositionObject 并释放系统资源。 (继承自 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	连接和动画。 (继承自 CompositionObject)
DisconnectAnimation(String)	断开动画的连接。 (继承自 CompositionObject)
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 CompositionObject)
InsertExpressionKeyFrame(Single, String)	插入表达式关键帧。 (继承自 KeyFrameAnimation)
InsertExpressionKeyFrame(Single, String, CompositionEasingFunction)	插入表达式关键帧。 (继承自 KeyFrameAnimation)
InsertKeyFrame(Single, Vector3)	插入关键帧。
InsertKeyFrame(Single, Vector3, CompositionEasingFunction)	插入具有指定缓动函数的关键帧。
PopulatePropertyInfo(String, AnimationPropertyInfo)	定义可进行动画处理的属性。 (继承自 CompositionObject)
SetBooleanParameter(String, Boolean)	设置用于 ExpressionAnimation 或 表达式关键帧的布尔值参数。 (继承自 CompositionAnimation)
SetColorParameter(String, Color)	设置用于 ExpressionAnimation 或表达式关键帧的 Color 值参数。 (继承自 CompositionAnimation)
SetExpressionReferenceParameter(String, IAnimationObject)	设置一个对象，该对象实现 IAnimationObject 作为 ExpressionAnimation 中的引用参数。 (继承自 CompositionAnimation)
SetMatrix3x2Parameter(String, Matrix3x2)	设置与 ExpressionAnimation 或表达式关键帧一起使用的 Matrix3x2 值参数。 (继承自 CompositionAnimation)
SetMatrix4x4Parameter(String, Matrix4x4)	设置与 ExpressionAnimation 或表达式关键帧一起使用的 Matrix4x4 值参数。 (继承自 CompositionAnimation)
SetQuaternionParameter(String, Quaternion)	设置用于 ExpressionAnimation 或 表达式关键帧的四元数值。 (继承自 CompositionAnimation)
SetReferenceParameter(String, CompositionObject)	设置对 Composition 对象的引用，以便与 ExpressionAnimation 或 表达式关键帧一起使用。 (继承自 CompositionAnimation)
SetScalarParameter(String, Single)	设置用于 ExpressionAnimation 或 表达式关键帧的标量值参数。 (继承自 CompositionAnimation)
SetVector2Parameter(String, Vector2)	设置用于 ExpressionAnimation 或表达式关键帧的 Vector2 值参数。 (继承自 CompositionAnimation)
SetVector3Parameter(String, Vector3)	设置用于 ExpressionAnimation 或表达式关键帧的 Vector3 值参数。 (继承自 CompositionAnimation)
SetVector4Parameter(String, Vector4)	设置用于 ExpressionAnimation 或表达式关键帧的 Vector4 值参数。 (继承自 CompositionAnimation)
StartAnimation(String, CompositionAnimation)	将动画与 对象的指定属性连接，并启动动画。 (继承自 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	将动画与 对象的指定属性连接，并启动动画。 (继承自 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	启动动画组。 使用 CompositionObject 上的 StartAnimationGroup 方法可以启动 CompositionAnimationGroup。 组中的所有动画都将在 对象上同时启动。 (继承自 CompositionObject)
StopAnimation(String)	断开动画与指定属性的连接，并停止动画。 (继承自 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止动画组。 (继承自 CompositionObject)
TryGetAnimationController(String)	返回指定属性上运行的动画的 AnimationController。 (继承自 CompositionObject)

另请参阅

• KeyFrameAnimation
• IClosable
• 合成动画概述