共用方式為


ConnectedAnimation 類別

定義

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

public ref class ConnectedAnimation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ConnectedAnimation final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ConnectedAnimation
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimation
Public NotInheritable Class ConnectedAnimation
繼承
Object Platform::Object IInspectable ConnectedAnimation
屬性

Windows 需求

裝置系列
Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

範例

提示

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

如果您已安裝 WinUI 2 資源庫 應用程式,請按一下這裡 開啟應用程式並查看連線動畫運作情形

備註

ConnectedAnimation 實例是由 ConnectedAnimationService.GetAnimationConnectedAnimationService.PrepareToAnimate方法傳回。

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

有已知限制,ConnectedAnimation 不適用於具有翻譯元件的主題轉換,包括 NavigationThemeTransitionEntranceThemeTransition。 當您使用 ConnectedAnimation 建立體驗時,建議您移除這些轉換,或使用 SuppressNavigationTransitionInfo隱藏流覽。

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

版本歷程記錄

Windows 版本 SDK 版本 已新增值
1703 15063 IsScaleAnimationEnabled
1703 15063 SetAnimationComponent
1703 15063 TryStart (UIElement,IEnumerable < UIElement >)
1809 17763 組態

屬性

Configuration

取得或設定組態,描述要播放的連接動畫類型。

IsScaleAnimationEnabled

取得或設定值,這個值表示是否應該使用連接動畫的縮放元件。

方法

Cancel()

停止連接的動畫。

SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)

設定自訂 CompositionAnimation 以變更連接動畫特定部分的動作。

TryStart(UIElement)

嘗試啟動動畫。

TryStart(UIElement, IIterable<UIElement>)

嘗試在目的地專案和指定的次要元素上啟動動畫。

事件

Completed

動畫完成時發生。

適用於

另請參閱