ConnectedAnimation Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimationPublic NotInheritable Class ConnectedAnimation- Vererbung
- Attribute
Beispiele
Tip
Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter "Verbundene Animation".
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.
Hinweise
Eine ConnectedAnimation-Instanz wird von den Methoden ConnectedAnimationService.GetAnimation und ConnectedAnimationService.PrepareToAnimate zurückgegeben.
Wenn Sie TryStart aufrufen, sollte das Element, das Sie an die Methode übergeben, seine Größe im Layout definiert haben. Dies bedeutet, dass entweder die Größe des Elements im Markup festgelegt werden soll, oder der Inhalt des Elements vollständig aufgefüllt werden soll, 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 eine Übersetzungskomponente aufweisen, 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 Erfahrung mit ConnectedAnimation erstellen.
Ein vollständiges Beispiel für ConnectedAnimation finden Sie im Beispiel für verbundene Animationen .
Eigenschaften
| Name | Beschreibung |
|---|---|
| Configuration |
Dient zum Abrufen oder Festlegen der Konfiguration, die den Typ der verbundenen Animation beschreibt, die wiedergegeben werden soll. |
| IsScaleAnimationEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Skalierungskomponente der verbundenen Animation verwendet werden soll. |
Methoden
| Name | Beschreibung |
|---|---|
| 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, IIterable<UIElement>) |
Versucht, die Animation für das Zielelement und die angegebenen sekundären Elemente zu starten. |
| TryStart(UIElement) |
Versucht, die Animation zu starten. |
Ereignisse
| Name | Beschreibung |
|---|---|
| Completed |
Tritt auf, wenn die Animation abgeschlossen ist. |