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)	傳回與指定之索引鍵和來源專案相關聯的連接動畫。

另請參閱

• 連線動畫概觀