ConnectedAnimation Klasse

Definition

Namespace:

Windows.UI.Xaml.Media.Animation

Stellt eine Animation dar, die gleichzeitig den Ausgang eines Elements und den Eingang eines anderen Elements animiert.

public ref class ConnectedAnimation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimation

Public NotInheritable Class ConnectedAnimation

Vererbung

Object Platform::Object IInspectable ConnectedAnimation

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Beispiele

Tipp

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

Wenn Sie die WinUI 2-Katalog-App installiert haben, klicken Sie hier, um die App zu öffnen und Verbundene Animation in Aktion zu sehen.

• Abrufen der WinUI 2-Katalog-App (Microsoft Store)
• Abrufen des Quellcodes (GitHub)

Hinweise

Ein ConnectedAnimation-instance wird von den Methoden ConnectedAnimationService.GetAnimation und ConnectedAnimationService.PrepareToAnimate zurückgegeben.

Wenn Sie TryStart aufrufen, sollte die Größe des Elements, das Sie an die -Methode übergeben, im Layout definiert sein. Dies bedeutet, dass entweder die Größe des Elements im Markup festgelegt oder der Inhalt des Elements vollständig aufgefüllt werden muss, damit seine Größe vom XAML-Framework berechnet werden kann. Wenn das Layout Teil eines ListView- oder GridView-Elements mit gebundenen Eigenschaften ist, müssen Sie den Inhalt möglicherweise manuell aktualisieren, um die Animation vorzubereiten, da Bindungen asynchron aktualisiert werden können.

Es gibt eine bekannte Einschränkung, bei der ConnectedAnimation nicht gut mit Designübergängen funktioniert, die über eine Übersetzungskomponente verfügen, einschließlich NavigationThemeTransition und EntranceThemeTransition. Es wird empfohlen, diese Übergänge zu entfernen oder die Navigation mithilfe von SuppressNavigationTransitionInfo zu unterdrücken, wenn Sie eine Benutzeroberfläche mit ConnectedAnimation erstellen.

Ein vollständiges Beispiel für ConnectedAnimation finden Sie im Beispiel für connectedAnimation.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1703	15063	IsScaleAnimationEnabled
1703	15063	SetAnimationComponent
1703	15063	TryStart(UIElement,IEnumerable<UIElement>)
1809	17763	Konfiguration

Eigenschaften

Configuration	Ruft die Konfiguration ab, die den Typ der wiedergegebenen verbundenen Animation beschreibt, oder legt diese fest.
IsScaleAnimationEnabled	Ruft einen Wert ab, der angibt, ob die Skalierungskomponente der verbundenen Animation verwendet werden soll, oder legt diesen fest.

Methoden

Cancel()	Beendet die verbundene Animation.
SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)	Legt eine benutzerdefinierte CompositionAnimation fest, um die Bewegung eines bestimmten Teils der verbundenen Animation zu ändern.
TryStart(UIElement)	Versucht, die Animation zu starten.
TryStart(UIElement, IIterable<UIElement>)	Versucht, die Animation für das Zielelement und die angegebenen sekundären Elemente zu starten.

Ereignisse

Completed

Tritt auf, wenn die Animation abgeschlossen ist.

Weitere Informationen

• ConnectedAnimationService