TransitionCollection Classe

Définition

Espace de noms:

Windows.UI.Xaml.Media.Animation

Représente une collection d’objets Transition . Chaque objet Transition représente une transition de thème différente, qui fait partie de la bibliothèque d’animations Windows Runtime.

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>

Héritage

Object Platform::Object IInspectable TransitionCollection

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IIterable<T> IEnumerable<T> IIterable<Transition> IEnumerable<Transition> IVector<Transition> IList<Transition>

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple montre la syntaxe XAML permettant de définir un élément d’objet TransitionCollection dans le cadre de la définition de la propriété UIElement.Transitions 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>

Remarques

TransitionCollection est utilisé comme type de valeur pour ces propriétés :

• Border.ChildTransitions
• ContentControl.ContentTransitions (sur les contrôles de contenu tels que Button ou AppBar)
• ContentPresenter.ContentTransitions
• ItemsControl.ItemContainerTransitions (sur les contrôles d’éléments tels que GridView, ListBox, ListView et Selector)
• ItemsPresenter.FooterTransitions
• ItemsPresenter.HeaderTransitions
• ListViewBase.FooterTransitions
• ListViewBase.HeaderTransitions
• Panel.ChildrenTransitions (sur grid, StackPanel et autres panneaux)
• Popup.ChildTransitions
• SettingsFlyoutTemplateSettings.ContentTransitions
• UIElement.Transitions (sur des centaines de classes)

Notes

Avant Windows 10, version 1809 (SDK 17763), la syntaxe XAML des propriétés qui ont une valeur TransitionCollection exige que vous déclariez un élément objet TransitionCollection explicite comme valeur, puis que vous fournissiez des éléments d’objet en tant qu’éléments enfants de TransitionCollection pour chacune des animations de transition que vous souhaitez utiliser. Dans Windows 10, version 1809 (SDK 17763) ou version ultérieure, TransitionCollection prend en charge l’utilisation implicite de la collection. Vous pouvez donc omettre l’élément objet collection. Pour plus d’informations sur les collections implicites et XAML, consultez guide de syntaxe XAML.

Les animations de transition sont des animations préconfigurées de la bibliothèque d’animations Windows Runtime. Les animations de transition s’exécutent automatiquement dans les conditions auxquelles l’animation de transition est associée, à l’aide du propriétaire de la propriété où transitionCollection est défini comme cible. Les propriétés animées varient en fonction de la transition que vous utilisez.

VisualStateGroup.Transitions n’utilise pas le type TransitionCollection. VisualStateGroup.Transitions utilise une collection intégrée (list ou vector) d’objets VisualTransition .

Énumération de la collection en C# ou Microsoft Visual Basic

Une TransitionCollection étant énumérable, vous pouvez utiliser une syntaxe spécifique au langage, telle que foreach en C# pour énumérer les éléments de la collection. Le compilateur effectue le casting de type pour vous et vous n’aurez pas besoin de caster IEnumerable<Transition> explicitement. Si vous avez besoin d’un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, effectuez un cast en IEnumerable<T> avec une contrainte Transition .

Constructeurs

TransitionCollection()

Initialise une nouvelle instance de la classe TransitionCollection.

Propriétés

Size	Obtient la taille (nombre) de la collection.

Méthodes

Append(Transition)	Ajoute un nouvel élément à la collection.
Clear()	Supprime tous les éléments de la collection.
First()	Retourne l’itérateur pour l’itération sur les éléments de la collection.
GetAt(UInt32)	Retourne l’élément situé à l’index spécifié.
GetMany(UInt32, Transition[])	Récupère plusieurs éléments en un seul passage par l’itérateur.
GetView()	Obtient une vue immuable dans la collection.
IndexOf(Transition, UInt32)	Récupère l’index de l’élément spécifié.
InsertAt(UInt32, Transition)	Insère l’élément spécifié à l’index spécifié.
RemoveAt(UInt32)	Supprime l'élément à l'index spécifié.
RemoveAtEnd()	Supprime le dernier élément de la collection.
ReplaceAll(Transition[])	Efface initialement la collection, puis insère le tableau fourni en tant que nouveaux éléments.
SetAt(UInt32, Transition)	Définit la valeur à l’index spécifié sur la valeur Transition spécifiée.

Voir aussi

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