ConnectedAnimation Klasse

  • Referenz

Definition

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

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)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ConnectedAnimation final
/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ConnectedAnimation
[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 ThreadingAttribute

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.

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.

Gilt für:

Weitere Informationen