UIElement.Transitions Eigenschaft

Definition

Ruft die Auflistung von Transition-Stilelementen ab, die für ein UIElement gelten, oder legt diese fest.

public:
 property TransitionCollection ^ Transitions { TransitionCollection ^ get(); void set(TransitionCollection ^ value); };
TransitionCollection Transitions();

void Transitions(TransitionCollection value);
public TransitionCollection Transitions { get; set; }
var transitionCollection = uIElement.transitions;
uIElement.transitions = transitionCollection;
Public Property Transitions As TransitionCollection
<uielement>
  <uielement.Transitions>
    <TransitionCollection>
      oneOrMoreTransitions
    </TransitionCollection>
  </uielement.Transitions>
</uielement>

Eigenschaftswert

Die stark typisierte Auflistung von Übergangsstilelementen , die für ein UIElement gelten.

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Bewegung.

Wenn Sie die WinUI 2-Katalog-App installiert haben, klicken Sie hier, um die App zu öffnen und implizite Übergänge und Designübergänge in Aktion zu sehen.

Dieses XAML-Beispiel zeigt eine einzelne EntranceThemeTransition , die in einem Stil für eine Schaltfläche definiert ist. Übergangsanimationseigenschaften werden in der Regel in Formatvorlagen und Vorlagen und nicht als Eigenschaften direkt in einer UI-Definition festgelegt. Formatvorlagen werden in der Regel als XAML-Ressource gespeichert.

<Grid Background="{StaticResource ApplicationPageBackgroundBrush}">
    <Grid.Resources>
        <Style x:Key="DefaultButtonStyle" TargetType="Button">
            <Setter Property="Transitions">
                <Setter.Value>
                    <TransitionCollection>
                        <EntranceThemeTransition/>
                    </TransitionCollection>
                </Setter.Value>
            </Setter>
        </Style>
    </Grid.Resources>

    <Button Style="{StaticResource DefaultButtonStyle}" 
            Content="EntranceThemeTransition style applied" />

</Grid>

Hinweise

Hinweis

Vor Windows 10, Version 1809 (SDK 17763) erfordert die XAML-Syntax für Eigenschaften mit einem TransitionCollection-Wert, dass Sie ein explizites TransitionCollection-Objektelement als Wert deklarieren und dann Objektelemente als untergeordnete Elemente von TransitionCollection für jede der zu verwendenden Übergangsanimationen bereitstellen. In Windows 10, Version 1809 (SDK 17763) oder höher unterstützt TransitionCollection die implizite Sammlungsverwendung, sodass Sie das Auflistungsobjektelement weglassen können. Weitere Informationen zu impliziten Sammlungen und XAML finden Sie unter XAML-Syntaxleitfaden.

Dies ist eine kurze Liste einiger möglicher Typen für Übergänge:

Bestimmte Klassen, die von UIElement abgeleitet werden, verfügen manchmal über eigene Eigenschaften, die andere Arten von Übergängen für klassenspezifische Szenarien enthalten. Beispiel: Popup.ChildTransitions und ItemsControl.ItemContainerTransitions.

Übergangsanimationen spielen beim Ui-Design Ihrer App eine besondere Rolle. Die Grundidee ist, dass die Animation den Benutzer auf die Änderung aufmerksam macht, wenn es eine Änderung oder einen Übergang gibt.

Es ist nicht üblich, den Wert der Transitions-Eigenschaft direkt auf einem UIElement festzulegen, das ein direktes Element der App-Benutzeroberfläche ist. Es ist üblicher, dass eine Übergänge-Auflistung Teil eines visuellen Zustands, einer Vorlage oder eines Stils ist. In diesem Fall verwenden Sie Mechanismen wie Setter eines Stils , um die Transitions-Eigenschaft anzugeben, und legen den Wert mithilfe von XAML-definierten Inhalten fest, die normalerweise als XAML-Ressource gespeichert werden.

VisualTransition gehört nicht zu den Typen, die Sie in die UIElement.Transitions-Auflistung einfügen. VisualTransition ist speziell für Animationen in visuellen Zustandsgruppen vorgesehen und wird von der VisualStateGroup.Transitions-Eigenschaft verwendet.

Gilt für:

Weitere Informationen