DiscreteObjectKeyFrame 類別

定義

命名空間:

Windows.UI.Xaml.Media.Animation

使用離散值，從上一個主要畫面格的 Object 值動畫到它自己的 Value 。

public ref class DiscreteObjectKeyFrame sealed : ObjectKeyFrame

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DiscreteObjectKeyFrame final : ObjectKeyFrame

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DiscreteObjectKeyFrame : ObjectKeyFrame

Public NotInheritable Class DiscreteObjectKeyFrame
Inherits ObjectKeyFrame

<DiscreteObjectKeyFrame ...>
  <DiscreteObjectKeyFrame.Value>
    objectValue
  </DiscreteObjectKeyFrame.Value>
</DiscreteObjectKeyFrame ...>
-or-
</DiscreteObjectKeyFrame Value="objectAsAttribute"...>

繼承

Object Platform::Object IInspectable DependencyObject ObjectKeyFrame DiscreteObjectKeyFrame

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

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

備註

主要畫面格動畫允許多個目標值，這些值會在動畫時間軸的某個時間到達。 換句話說，每個主要畫面格都可以指定不同的中繼值，最後一個到達的主要畫面格就是最終的動畫值。 在動畫中指定多個值可以製作更複雜的動畫。

DiscreteObjectKeyFrame 是 ObjectAnimationUsingKeyFrames中唯一允許的主要畫面格類型。 在動畫執行時，沒有任何線性插補或其他插補邏輯可以變更物件值。 舊物件會在 KeyTime 移除，而新物件是 KeyTime 取代主要畫面格的值。

在某些情況下，使用 ObjectAnimationUsingKeyFrames 而非具類型的動畫很有用。 以下是其中幾個屬性：

• 建立視覺狀態的 分鏡腳本 ，並使用 { StaticResource} 標記延伸 參考的值，而不是其中一個具型別的值。 這可讓您從視覺狀態參考系統主題資源。 如需詳細資訊，請參閱 視覺狀態的分鏡腳本動畫。
• 以 動畫顯示 int 或 位元組 值。
• 動畫顯示 UI 定義和視覺狀態中使用的結構，例如 GridLength。 您無法以動畫顯示結構的屬性，但您可以使用 DiscreteObjectKeyFrame 和新的 GridLength交換整個結構值。

如需如何使用主要畫面格動畫的詳細資訊，請參閱 主要畫面格動畫和 Easing 函式動畫。

建構函式

DiscreteObjectKeyFrame()

初始化 DiscreteObjectKeyFrame 類別的新實例。

屬性

Dispatcher	取得與此物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可以存取 UI 執行緒上DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject)
KeyTime	取得或設定應該達到主要畫面格目標 值 的時間。 (繼承來源 ObjectKeyFrame)
Value	取得或設定主要畫面格的目標值。 (繼承來源 ObjectKeyFrame)

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	傳回針對相依性屬性所建立的任何基底值，如果動畫未使用中，則會套用。 (繼承來源 DependencyObject)
GetValue(DependencyProperty)	從 DependencyObject傳回相依性屬性的目前有效值。 (繼承來源 DependencyObject)
ReadLocalValue(DependencyProperty)	如果已設定本機值，則傳回相依性屬性的本機值。 (繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊通知函式，以接聽此DependencyObject實例上特定DependencyProperty的變更。 (繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)	在 DependencyObject上設定相依性屬性的本機值。 (繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback註冊的變更通知。 (繼承來源 DependencyObject)

另請參閱

• ObjectKeyFrame
• ObjectAnimationUsingKeyFrames
• 腳本動畫
• 主要畫面格動畫和 Easing 函式動畫
• 視覺狀態的腳本動畫