ConnectedAnimationService 類別

定義

命名空間:

Microsoft.UI.Xaml.Media.Animation

表示提供屬性和方法以顯示 ConnectedAnimation 的服務。

public ref class ConnectedAnimationService sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [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(Microsoft.UI.Xaml.WinUIContract), 65536)]
[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

範例

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 連線動畫。

開啟 WinUI 3 資源庫應用程式，並查看 ConnectedAnimation 的運作情形。

WinUI 3 資源庫應用程式包含大部分 WinUI 3 控制件、特性和功能的互動式範例。 從 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)	傳回與指定之索引鍵和來源項目相關聯的連接動畫。

另請參閱

• 聯機動畫概觀