Sprache

ConnectedAnimationService Klasse

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

Tip

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter "Verbundene Animation".

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

Die WinUI 3 Gallery-App enthält interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Holen Sie sich die App aus dem Microsoft Store oder holen Sie sich den Quellcode auf GitHub.

In diesem Beispiel wird gezeigt, wie Sie ein Bild während einer Navigation 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

Rufen Sie zum Abrufen einer Instanz von ConnectedAnimationService 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 diese Taste später verwenden, um dieselbe 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 zwischen Seiten manuell übergeben zu müssen.

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

Eigenschaften

Name Beschreibung
DefaultDuration

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

Dient zum Abrufen oder Festlegen der standardmäßigen CompositionEasingFunction , die von der Animation verwendet wird.

Methoden

Name Beschreibung
GetAnimation(String)

Gibt die Animation mit der angegebenen Taste zurück.
GetForCurrentView()

Gibt eine Instanz 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