ConnectedAnimation 類別

定義

命名空間:

Microsoft.UI.Xaml.Media.Animation

表示同時以動畫顯示某個元素結束和另一個專案入口的動畫。

public ref class ConnectedAnimation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimation

Public NotInheritable Class ConnectedAnimation

繼承

Object Platform::Object IInspectable ConnectedAnimation

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

範例

提示

如需詳細資訊、設計指引和程式代碼範例，請參閱 連線的動畫。

開啟 WinUI 3 資源庫應用程式，並查看 ConnectedAnimation 的運作。

WinUI 3 資源庫 應用程式包含大部分 WinUI 3 控制件、特性和功能的互動式範例。 從 Microsoft Store 取得應用程式，或在 GitHub取得原始程式碼。

備註

ConnectedAnimation 實例是由 ConnectedAnimationService.GetAnimation 和 ConnectedAnimationService.PrepareToAnimate 方法所傳回。

當您呼叫 TryStart時，您傳入方法的項目應該會在配置中定義其大小。 這表示元素的大小應該在標記中設定，或專案的內容應該完整填入，以便 XAML 架構計算其大小。 如果版面配置屬於 ListView 或 GridView 具有系結屬性的專案，您可能必須手動更新內容以準備動畫，因為系結可以異步更新。

有一個已知的限制，ConnectedAnimation 不適用於具有翻譯元件的主題轉換，包括 NavigationThemeTransition 和 EntranceThemeTransition。 當您使用 ConnectedAnimation 建立體驗時，建議您移除這些轉換，或使用 suppressNavigationTransitionInfo 來隱藏流覽。

如需 ConnectedAnimation 的完整範例，請參閱 Connected 動畫範例。

屬性

Configuration	取得或設定描述要播放之已連線動畫類型的組態。
IsScaleAnimationEnabled	取得或設定值，這個值表示是否應該使用連接的動畫縮放元件。

方法

Cancel()	停止連接的動畫。
SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)	設定自定義 CompositionAnimation 來變更連接動畫特定部分的動作。
TryStart(UIElement, IIterable<UIElement>)	嘗試在目的地專案和指定的次要元素上啟動動畫。
TryStart(UIElement)	嘗試啟動動畫。

事件

Completed

動畫完成時發生。

另請參閱

• ConnectedAnimationService