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)	嘗試啟動動畫。
TryStart(UIElement, IIterable<UIElement>)	嘗試在目的地專案和指定的次要專案上啟動動畫。

事件

Completed

動畫完成時發生。

另請參閱

• ConnectedAnimationService