共用方式為

ConnectedAnimation 類別

  • 參考

定義

命名空間:
Windows.UI.Xaml.Media.Animation
編輯

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

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
屬性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

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

範例

提示

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

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

備註

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

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

有已知限制，ConnectedAnimation 不適用於具有翻譯元件的主題轉換，包括 NavigationThemeTransition 和 EntranceThemeTransition。 當您使用 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

動畫完成時發生。

適用於

另請參閱