ColorKeyFrameAnimation 類別

定義

命名空間:

Windows.UI.Composition

以一或多個色彩主要畫面格為目標之 Color 屬性的時間型動畫。

ColorKeyFrameAnimation 類別是KeyFrameAnimation支援的其中一種類型，用來在SpriteVisual上產生Brush屬性的Color屬性動畫效果。 使用 ColorKeyFrameAnimation s 時，請利用 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

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.StartAnimation 和 CompostionObject.StopAnimation 方法來啟動和停止動畫。

動畫會呼叫 CompositionObject.StartAnimation 並指定屬性名稱和動畫，以與物件的屬性相關聯。 如需可產生動畫屬性的清單，請參閱 CompositionObject.StartAnimation 的備註一節。

屬性

Comment	要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject)
Compositor	用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject)
DelayBehavior	主要畫面格動畫的延遲行為。 (繼承來源 KeyFrameAnimation)
DelayTime	呼叫 CompositionObject.StartAnimation 之後動畫開始之前的延遲。 (繼承來源 KeyFrameAnimation)
Direction	動畫現正播放的方向。 Direction屬性可讓您在動畫有大於一個的IterationCount時，從頭到端或端對端驅動動畫，從開始或端對端開始或替代。 這可讓您輕鬆自訂動畫定義。 (繼承來源 KeyFrameAnimation)
Dispatcher	CompositionObject的發送器。 (繼承來源 CompositionObject)
DispatcherQueue	取得 CompostionObject 的 DispatcherQueue 。 (繼承來源 CompositionObject)
Duration	動畫的持續時間。 (繼承來源 KeyFrameAnimation)
ImplicitAnimations	附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject)
InitialValueExpressions	取得動畫的初始值。 (繼承來源 CompositionAnimation)
InterpolationColorSpace	色彩插補應該執行的色彩空間。 ColorKeyFrameAnimation.InterpolationColorSpace屬性可讓開發人員選擇在兩種色彩之間以動畫顯示時，系統會插入的色彩空間。 開發人員可以選擇 CompositionColorSpace 列舉值 Rgb、Hsl 或自動 (系統選擇) 。
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()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承來源 CompositionObject)
InsertExpressionKeyFrame(Single, String)	插入運算式主要畫面格。 (繼承來源 KeyFrameAnimation)
InsertExpressionKeyFrame(Single, String, CompositionEasingFunction)	插入運算式主要畫面格。 (繼承來源 KeyFrameAnimation)
InsertKeyFrame(Single, Color)	插入主要畫面格。
InsertKeyFrame(Single, Color, CompositionEasingFunction)	使用指定的 easing 函式插入主要畫面格。
PopulatePropertyInfo(String, AnimationPropertyInfo)	定義可以產生動畫效果的屬性。 (繼承來源 CompositionObject)
SetBooleanParameter(String, Boolean)	設定布林值參數，以搭配 ExpressionAnimation 或 運算式主要畫面格使用。 (繼承來源 CompositionAnimation)
SetColorParameter(String, Color)	設定 Color 值參數，以搭配 ExpressionAnimation 或 運算式主要畫面格使用。 (繼承來源 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)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	啟動動畫群組。 CompositionObject上的 StartAnimationGroup 方法可讓您啟動CompositionAnimationGroup。 群組中的所有動畫都會在 物件上同時啟動。 (繼承來源 CompositionObject)
StopAnimation(String)	中斷與指定屬性的動畫連線，並停止動畫。 (繼承來源 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止動畫群組。 (繼承來源 CompositionObject)
TryGetAnimationController(String)	傳回在指定屬性上執行的動畫的 AnimationController。 (繼承來源 CompositionObject)

另請參閱

• KeyFrameAnimation
• IClosable
• 組合動畫概觀