TransitionCollection Klasse

Definition

Namespace:

Windows.UI.Xaml.Media.Animation

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.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class TransitionCollection final : IIterable<Transition>, IVector<Transition>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
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<T> IEnumerable<T> IIterable<Transition> IEnumerable<Transition> IVector<Transition> IList<Transition>

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Dieses Beispiel zeigt die XAML-Syntax zum Festlegen eines TransitionCollection-Objektelements beim Festlegen 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:

• Border.ChildTransitions
• ContentControl.ContentTransitions (für Inhaltssteuerelemente wie Schaltfläche oder AppBar)
• ContentPresenter.ContentTransitions
• ItemsControl.ItemContainerTransitions (für Elementsteuerelemente wie GridView, ListBox, ListView und Selector)
• ItemsPresenter.FooterTransitions
• ItemsPresenter.HeaderTransitions
• ListViewBase.FooterTransitions
• ListViewBase.HeaderTransitions
• Panel.ChildrenTransitions (in Grid, StackPanel und anderen Panels)
• Popup.ChildTransitions
• SettingsFlyoutTemplateSettings.ContentTransitions
• UIElement.Transitions (für Hunderte von Klassen)

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.

Ü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 wird. 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> umgewandelt werden. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie mit einer Übergangseinschränkung in IEnumerable<T> 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 einzelnen Durchgang 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.

Weitere Informationen

• Transitions
• ContentTransitions
• ChildrenTransitions
• IVector<T>
• IIterable<T>
• IList< T>