ColorKeyFrameAnimation 类

定义

一个基于时间的动画,以具有一个或多个颜色关键帧的 Color 属性为目标。

ColorKeyFrameAnimation 类是受支持的 KeyFrameAnimation类型之一,用于对 SpriteVisual 上的 Brush 属性的 Color 属性进行动画处理。 使用 ColorKeyFrameAnimation 时,请利用 Windows.UI.Color 对象获取关键帧的值。 利用 InterpolationColorSpace 属性定义系统将通过哪些颜色空间插入动画。

public ref class ColorKeyFrameAnimation sealed : KeyFrameAnimation
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ColorKeyFrameAnimation final : KeyFrameAnimation
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ColorKeyFrameAnimation : KeyFrameAnimation
Public NotInheritable Class ColorKeyFrameAnimation
Inherits KeyFrameAnimation
继承
Object Platform::Object IInspectable CompositionObject CompositionAnimation KeyFrameAnimation ColorKeyFrameAnimation
属性

Windows 要求

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

示例

void ColorAnimation(SpriteVisual visual)
{
  // Create the ColorKeyFrameAnimation
  var colorAnimation = _compositor.CreateColorKeyFrameAnimation();

  // Create the KeyFrames using Windows.UI.Color objects
  colorAnimation.InsertKeyFrame(0.5f, Colors.Purple);
  colorAnimation.InsertKeyFrame(1.0f, Colors.Cyan);

  // Set the interpolation to go through the HSL space
  colorAnimation.InterpolationColorSpace = CompositionColorSpace.Hsl;
  colorAnimation.Duration = TimeSpan.FromSeconds(3);

  // Apply the cubic-bezier to a KeyFrame
  visual.Brush.StartAnimation("Color", colorAnimation);
}

注解

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

动画通过调用 CompositionObject.StartAnimation 并指定属性名称和动画来与对象的 属性相关联。 有关可动画属性的列表,请参阅 CompositionObject.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)
InterpolationColorSpace

颜色内插应运行的颜色空间。

ColorKeyFrameAnimation.InterpolationColorSpace 属性使开发人员能够选择系统在两种颜色之间进行动画处理时将内插的颜色空间。 开发人员可以在 选择的 CompositionColorSpace 枚举值 Rgb、Hsl 或 Auto (系统) 之间进行选择。

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, Color)

插入关键帧。

InsertKeyFrame(Single, Color, 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)

适用于

另请参阅