ColorKeyFrameAnimation 类

定义

命名空间:

Microsoft.UI.Composition

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

ColorKeyFrameAnimation 类是 KeyFrameAnimation支持的类型之一，用于在 SpriteVisual上 Brush 属性的 Color 属性上设置动画。 使用 ColorKeyFrameAnimation 时，将 Windows.UI.Color 对象用于关键帧的值。 利用 InterpolationColorSpace 属性定义系统为动画内插的哪些颜色空间。

public ref class ColorKeyFrameAnimation sealed : KeyFrameAnimation

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class ColorKeyFrameAnimation 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(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class ColorKeyFrameAnimation : KeyFrameAnimation

Public NotInheritable Class ColorKeyFrameAnimation
Inherits KeyFrameAnimation

继承

Object Platform::Object IInspectable CompositionObject CompositionAnimation KeyFrameAnimation ColorKeyFrameAnimation

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

示例

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

注解

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

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

属性

Comment	要与 CompositionObject 关联的字符串。 (继承自 CompositionObject)
Compositor	用于创建此 CompositionObject的 Compositor。 (继承自 CompositionObject)
DelayBehavior	关键帧动画的延迟行为。 (继承自 KeyFrameAnimation)
DelayTime	调用 CompositionObject.StartAnimation 之后动画开始前的延迟。 (继承自 KeyFrameAnimation)
Direction	动画正在播放的方向。 Direction 属性允许在动画具有 IterationCount 大于 1 的情况下，从头到尾驱动动画从头到尾或从头开始或交替。 这为自定义动画定义提供了一种简单的方法。 (继承自 KeyFrameAnimation)
DispatcherQueue	获取 CompositionObject 的 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)
Dispose()	执行与释放、释放或重置非托管资源关联的应用程序定义任务。 (继承自 CompositionObject)
InsertExpressionKeyFrame(Single, String, CompositionEasingFunction)	插入表达式关键帧。 (继承自 KeyFrameAnimation)
InsertExpressionKeyFrame(Single, String)	插入表达式关键帧。 (继承自 KeyFrameAnimation)
InsertKeyFrame(Single, Color, CompositionEasingFunction)	使用指定的缓动函数插入关键帧。
InsertKeyFrame(Single, Color)	插入关键帧。
PopulatePropertyInfo(String, AnimationPropertyInfo)	定义可以进行动画处理的属性。 (继承自 CompositionObject)
SetBooleanParameter(String, Boolean)	设置一个布尔值参数，用于 ExpressionAnimation 或 表达式关键帧。 (继承自 CompositionAnimation)
SetColorParameter(String, Color)	设置与 ExpressionAnimation 或 表达式关键帧一起使用的 Color 值参数。 (继承自 CompositionAnimation)
SetExpressionReferenceParameter(String, IAnimationObject)	设置一个对象，该对象实现 IAnimationObject 作为 ExpressionAnimation中的引用参数。 (继承自 CompositionAnimation)
SetMatrix3x2Parameter(String, Matrix3x2)	设置 Matrix3x2 值参数，以便与 ExpressionAnimation 或 表达式关键帧一起使用。 (继承自 CompositionAnimation)
SetMatrix4x4Parameter(String, Matrix4x4)	设置 Matrix4x4 值参数，以便与 ExpressionAnimation 或 表达式关键帧一起使用。 (继承自 CompositionAnimation)
SetQuaternionParameter(String, Quaternion)	设置与 ExpressionAnimation 或 表达式关键帧一起使用的四元数值。 (继承自 CompositionAnimation)
SetReferenceParameter(String, CompositionObject)	设置对 Composition 对象的引用，以便与 ExpressionAnimation 或 表达式关键帧一起使用。 (继承自 CompositionAnimation)
SetScalarParameter(String, Single)	设置一个标量值参数，用于 ExpressionAnimation 或 表达式关键帧。 (继承自 CompositionAnimation)
SetVector2Parameter(String, Vector2)	设置一个 Vector2 值参数，用于 ExpressionAnimation 或 表达式关键帧。 (继承自 CompositionAnimation)
SetVector3Parameter(String, Vector3)	设置 Vector3 值参数，以便与 ExpressionAnimation 或 表达式关键帧一起使用。 (继承自 CompositionAnimation)
SetVector4Parameter(String, Vector4)	设置一个 Vector4 值参数，用于 ExpressionAnimation 或 表达式关键帧。 (继承自 CompositionAnimation)
StartAnimation(String, CompositionAnimation, AnimationController)	将动画与对象的指定属性连接，并启动动画。 (继承自 CompositionObject)
StartAnimation(String, CompositionAnimation)	将动画与对象的指定属性连接，并启动动画。 (继承自 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	启动动画组。 CompositionObject 上的 StartAnimationGroup 方法可用于启动 compositionAnimationGroup。 组中的所有动画将在对象上同时启动。 (继承自 CompositionObject)
StopAnimation(String)	断开与指定属性的动画的连接，并停止动画。 (继承自 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止动画组。 (继承自 CompositionObject)
TryGetAnimationController(String)	返回指定属性上运行的动画的 AnimationController。 (继承自 CompositionObject)

另请参阅

• KeyFrameAnimation
• 合成动画概述
• IClosable