Freigeben über

TransitionCollection Klasse

  • Referenz

Definition

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

Stellt eine Auflistung von Transition-Objekten dar. Jedes Transition-Objekt stellt einen anderen Designübergang dar, der Teil der Windows-Runtime Animationsbibliothek ist.

public ref class TransitionCollection sealed : IIterable<Transition ^>, IVector<Transition ^>
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class TransitionCollection final : IIterable<Transition>, IVector<Transition>
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class TransitionCollection : IEnumerable<Transition>, IList<Transition>
Public NotInheritable Class TransitionCollection
Implements IEnumerable(Of Transition), IList(Of Transition)
<TransitionCollection>
    oneOrMoreTransitions
</TransitionCollection>
Vererbung
Object Platform::Object IInspectable TransitionCollection
Attribute
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Implementiert
IIterable<Transition> IEnumerable<Transition> IIterable<T> IEnumerable<T> IVector<Transition> IList<Transition>

Beispiele

Dieses Beispiel zeigt die XAML-Syntax zum Festlegen eines TransitionCollection-Objektelements als Teil des Festlegens der UIElement.Transitions-Eigenschaft inline.

<Button Content="EntranceThemeTransition Button">
    <Button.Transitions>
        <TransitionCollection>
            
            <!-- This transition just uses the default behavior which is to
                 have the button animate into view from the right. You can
                 make it start from anywhere on the right by using the
                 FromHorizontalOffset property. If you'd rather see a vertical
                 animation, use the FromVerticalOffset property. -->
            <EntranceThemeTransition />
        </TransitionCollection>
    </Button.Transitions>
</Button>

<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

TransitionCollection wird als Werttyp für diese Eigenschaften verwendet:

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.

Übergangsanimationen sind vorkonfigurierte Animationen aus der Windows-Runtime Animationsbibliothek. Übergangsanimationen werden automatisch unter den Bedingungen ausgeführt, denen die Übergangsanimation zugeordnet ist, wobei der Eigenschaftenbesitzer verwendet wird, bei dem die TransitionCollection als Ziel festgelegt ist. Die animierten Eigenschaften variieren je nach verwendetem Übergang.

VisualStateGroup.Transitions verwendet nicht den TransitionCollection-Typ. VisualStateGroup.Transitions verwendet eine integrierte Auflistung (Liste oder Vektor) von VisualTransition-Objekten .

Auflisten der Sammlung in C# oder Microsoft Visual Basic

Eine TransitionCollection ist aufzählbar, sodass Sie sprachspezifische Syntax wie foreach in C# verwenden können, um die Elemente in der Auflistung aufzulisten. Der Compiler führt die Typumwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable<Transition> umwandeln. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie mit einer Transition-Einschränkung in IEnumerable um.

Konstruktoren

TransitionCollection()

Initialisiert eine neue instance der TransitionCollection-Klasse.

Eigenschaften

Size

Ruft die Größe (Anzahl) der Auflistung ab.

Methoden

Append(Transition)

Fügt der Auflistung ein neues Element hinzu.
Clear()

Entfernt alle Elemente aus der Auflistung.
First()

Gibt den Iterator für die Iteration über die Elemente in der Auflistung zurück.
GetAt(UInt32)

Gibt das Element zurück, das sich am angegebenen Index befindet.
GetMany(UInt32, Transition[])

Ruft mehrere Elemente in einem einzigen Durchlauf durch den Iterator ab.
GetView()

Ruft eine unveränderliche Ansicht in die Auflistung ab.
IndexOf(Transition, UInt32)

Ruft den Index des angegebenen Elements ab.
InsertAt(UInt32, Transition)

Fügt das angegebene Element am angegebenen Index ein.
RemoveAt(UInt32)

Entfernt das Element am angegebenen Index.
RemoveAtEnd()

Entfernt das letzte Element in der Auflistung.
ReplaceAll(Transition[])

Löscht zunächst die Auflistung und fügt dann das bereitgestellte Array als neue Elemente ein.
SetAt(UInt32, Transition)

Legt den Wert am angegebenen Index auf den angegebenen Transition-Wert fest.

Gilt für:

Weitere Informationen