UIElement.Transitions Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

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

TransitionCollection

Die stark typisierte Auflistung von Transition-Stilelementen , die für ein UIElement gelten.

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Motion.

Öffnen Sie die WinUI 3-Katalog-App, und sehen Sie sich Übergänge in Aktion an.

Die WinUI 3-Katalog-App umfasst interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.

Das folgende XAML-Beispiel zeigt eine einzelne EntranceThemeTransition , die in einer Formatvorlage für eine Schaltfläche definiert ist. Übergangsanimationseigenschaften werden in der Regel in Formatvorlagen und Vorlagen anstatt 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-Syntaxhandbuch.

Dies ist eine kurze Liste mit einigen der möglichen Typen für Übergänge:

• AddDeleteThemeTransition
• ContentThemeTransition
• EdgeUIThemeTransition
• EntranceThemeTransition
• PopupThemeTransition
• ReorderThemeTransition
• RepositionThemeTransition

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

Übergangsanimationen spielen eine besondere Rolle beim Ui-Design Ihrer App. 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 häufiger, dass eine Transitions-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 Inhalt fest, der normalerweise als XAML-Ressource gespeichert wird.

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 und wird von der VisualStateGroup.Transitions-Eigenschaft verwendet.

Weitere Informationen

• TransitionCollection
• Storyboardanimationen