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 库应用,并在操作中看到 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, IIterable<UIElement>) |
尝试在目标元素和指定的辅助元素上启动动画。 |
TryStart(UIElement) |
尝试启动动画。 |
事件
Completed |
动画完成时发生。 |