TransitionCollection Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class TransitionCollection final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class TransitionCollection : IEnumerable<Transition>, IList<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
- Attributs
- Implémente
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. |