KeyFrameAnimation 類別

定義

命名空間:

Windows.UI.Composition

具有一或多個主要畫面格的時間型動畫。 這些畫面是標記，可讓開發人員在特定時間指定動畫屬性的值。 您可以藉由指定動畫在主要畫面格之間插補的方式，進一步自訂 KeyFrame 動畫。

public ref class KeyFrameAnimation : CompositionAnimation

/// [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 KeyFrameAnimation : CompositionAnimation

[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 class KeyFrameAnimation : CompositionAnimation

Public Class KeyFrameAnimation
Inherits CompositionAnimation

繼承

Object Platform::Object IInspectable CompositionObject CompositionAnimation KeyFrameAnimation

衍生

Windows.UI.Composition.BooleanKeyFrameAnimation

Windows.UI.Composition.ColorKeyFrameAnimation

Windows.UI.Composition.PathKeyFrameAnimation

Windows.UI.Composition.QuaternionKeyFrameAnimation

Windows.UI.Composition.ScalarKeyFrameAnimation

Windows.UI.Composition.Vector2KeyFrameAnimation

Windows.UI.Composition.Vector3KeyFrameAnimation

Windows.UI.Composition.Vector4KeyFrameAnimation

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

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

KeyFrameAnimation 不會在應用程式的進程暫停時自動停止。 您必須訂閱應用程式狀態事件，並在應用程式暫停之前停止或暫停動畫。 如需應用程式暫停的詳細資訊，請參閱 應用程式生命週期。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1607	14393	方向
1703	15063	DelayBehavior

屬性

Comment	要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject)
Compositor	用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject)
DelayBehavior	主要畫面格動畫的延遲行為。
DelayTime	呼叫 CompositionObject.StartAnimation 之後動畫開始之前的延遲。
Direction	動畫現正播放的方向。 Direction屬性可讓您在動畫有大於一個的IterationCount時，從頭到端或端對端驅動動畫，從開始或端對端開始或替代。 這可讓您輕鬆自訂動畫定義。
Dispatcher	CompositionObject的發送器。 (繼承來源 CompositionObject)
DispatcherQueue	取得 CompostionObject 的 DispatcherQueue 。 (繼承來源 CompositionObject)
Duration	動畫的持續時間。
ImplicitAnimations	附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject)
InitialValueExpressions	取得動畫的初始值。 (繼承來源 CompositionAnimation)
IterationBehavior	主要畫面格動畫的反復專案行為。
IterationCount	重複主要畫面格動畫的次數。
KeyFrameCount	KeyFrameAnimation中的主要畫面格數目。
Properties	與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject)
StopBehavior	指定呼叫 StopAnimation 時如何設定屬性值。
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)	插入運算式主要畫面格。
InsertExpressionKeyFrame(Single, String, CompositionEasingFunction)	插入運算式主要畫面格。
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)

另請參閱

• CompositionAnimation
• IClosable
• 組合動畫概觀