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