ConnectedAnimation 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
表示動畫,該動畫會同時動畫顯示某個元素的結束,以及另一個項目的進入。
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
- 繼承
- 屬性
範例
提示
如需詳細資訊、設計指引和程式碼範例,請參閱 連線動畫。
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 |
動畫完成時發生。 |