Freigeben über

ConnectedAnimationService Klasse

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml.Media.Animation
Bearbeiten

Stellt einen Dienst dar, der Eigenschaften und Methoden zum Anzeigen einer ConnectedAnimation bereitstellt.

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
Vererbung
Object Platform::Object IInspectable ConnectedAnimationService
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Tipp

Weitere Informationen, Entwurfsleitfäden und Codebeispiele finden Sie unter Verbundene Animation.

Öffnen Sie die WinUI 3-Katalog-App, und sehen Sie ConnectedAnimation in Aktion.

Die WinUI 3-Katalog-App umfasst interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.

In diesem Beispiel wird gezeigt, wie Sie während einer Navigation ein Bild zwischen zwei Seiten animieren.

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);
    }
}

Hinweise

Um eine instance von ConnectedAnimationService abzurufen, rufen Sie die statische GetForCurrentView-Methode auf.

Wenn Sie PrepareToAnimate aufrufen, geben Sie einen Schlüssel an, der der neu erstellten ConnectedAnimation zugeordnet werden soll, die von der -Methode zurückgegeben wird. Sie können diesen Schlüssel später verwenden, um die gleiche Animation abzurufen, indem Sie GetAnimation aufrufen. Auf diese Weise können Sie die Animation zwischen zwei verschiedenen Seiten verbinden, ohne den Verweis auf das ConnectedAnimation-Objekt manuell zwischen Seiten übergeben zu müssen.

Ein vollständiges Beispiel für ConnectedAnimationService finden Sie im Beispiel für connectedAnimationService.

Eigenschaften

DefaultDuration

Ruft die Standardzeit ab, zu der die Animation ausgeführt wird, oder legt diese fest.
DefaultEasingFunction

Ruft die von der Animation verwendete CompositionEasingFunction-Standardfunktion ab oder legt sie fest.

Methoden

GetAnimation(String)

Gibt die Animation mit dem angegebenen Schlüssel zurück.
GetForCurrentView()

Gibt einen instance von ConnectedAnimationService für die aktuelle Ansicht zurück.
PrepareToAnimate(String, UIElement)

Gibt eine verbundene Animation zurück, die dem angegebenen Schlüssel und Quellelement zugeordnet ist.

Gilt für:

Weitere Informationen