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 ConnectedAnimationPublic NotInheritable Class 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 |
动画完成时发生。 |