ConnectedAnimationService 类

定义

命名空间:

Windows.UI.Xaml.Media.Animation

表示提供用于显示 ConnectedAnimation 的属性和方法的服务。

public ref class ConnectedAnimationService 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 ConnectedAnimationService 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 ConnectedAnimationService

Public NotInheritable Class ConnectedAnimationService

继承

Object Platform::Object IInspectable ConnectedAnimationService

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

示例

提示

有关详细信息、设计指南和代码示例，请参阅 连接动画。

如果已安装 WinUI 2 库 应用，请单击此处 打开该应用，并查看连接动画的运行情况。

• 获取 WinUI 2 库应用 (Microsoft Store)
• 获取源代码 (GitHub)

此示例演示如何在导航期间对两个页面之间的图像进行动画处理。

SourcePage.xaml/SourcePage.xaml.cs

<Image x:Name="SourceImage"
       Width="200"
       Height="200"
       Stretch="Fill"
       Source="Assets/StoreLogo.png" />

private void NavigateToDestinationPage()
{
    ConnectedAnimationService.GetForCurrentView().PrepareToAnimate("image", SourceImage);
    Frame.Navigate(typeof(DestinationPage));
}

DestinationPage.xaml/DestinationPage.xaml.cs

<Image x:Name="DestinationImage"
       Width="400"
       Height="400"
       Stretch="Fill"
       Source="Assets/StoreLogo.png" />

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    base.OnNavigatedTo(e);

    ConnectedAnimation imageAnimation = 
        ConnectedAnimationService.GetForCurrentView().GetAnimation("image");
    if (imageAnimation != null)
    {
        imageAnimation.TryStart(DestinationImage);
    }
}

注解

若要获取 ConnectedAnimationService 的实例，请调用静态 GetForCurrentView 方法。

调用 PrepareToAnimate 时，需要提供一个与 方法返回的新创建的 ConnectedAnimation 关联的密钥。 稍后可以使用此键通过调用 GetAnimation 来检索相同的动画。 这使你可以在两个不同的页面之间连接动画，而无需在页面之间手动传递对 ConnectedAnimation 对象的引用。

有关 ConnectedAnimationService 的完整示例，请参阅 Connected 动画示例 。

属性

DefaultDuration	获取或设置动画运行的默认时间。
DefaultEasingFunction	获取或设置动画使用的默认 CompositionEasingFunction 。

方法

GetAnimation(String)	返回具有指定键的动画。
GetForCurrentView()	返回当前视图的 ConnectedAnimationService 实例。
PrepareToAnimate(String, UIElement)	返回与指定的键和源元素关联的连接动画。

另请参阅

• 连接的动画概述