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

属性

Configuration

获取或设置描述要播放的连接动画类型的配置。
IsScaleAnimationEnabled

获取或设置一个值，该值指示是否应使用连接的动画的缩放组件。

方法

Cancel()

停止连接的动画。
SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)

设置自定义 CompositionAnimation 以更改已连接动画的特定部分的运动。
TryStart(UIElement)

尝试启动动画。
TryStart(UIElement, IIterable<UIElement>)

尝试在目标元素和指定的辅助元素上启动动画。

事件

Completed

动画完成时发生。

适用于

另请参阅