UIElement.Transitions Propriété

Définition

Espace de noms:

Windows.UI.Xaml

Obtient ou définit la collection d’éléments de style Transition qui s’appliquent à un élément UIElement.

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>

Valeur de propriété

TransitionCollection

Collection fortement typée d’éléments de style Transition qui s’appliquent à un UIElement.

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Motion.

Si vous avez installé l’application Galerie WinUI 2 , cliquez ici pour ouvrir l’application et voir Transitions implicites et transitions de thème en action.

• Obtenir l’application WinUI 2 (Microsoft Store)
• Obtenir le code source (GitHub)

Cet exemple XAML montre un seul élément EntranceThemeTransition tel que défini dans un style pour un bouton. Les propriétés d’animation de transition sont généralement définies dans des styles et des modèles plutôt qu’en tant que propriétés directement dans une définition d’interface utilisateur. Les styles sont généralement stockés en tant que ressource XAML.

<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

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 d’objet TransitionCollection explicite comme valeur, puis que vous fournissiez des éléments 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 de collection. Pour plus d’informations sur les collections implicites et XAML, consultez le Guide de syntaxe XAML.

Voici une courte liste de certains des types possibles pour les transitions :

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

Les classes spécifiques qui dérivent d’UIElement ont parfois leurs propres propriétés qui contiennent d’autres types de transitions pour des scénarios spécifiques à une classe. Par exemple, Popup.ChildTransitions et ItemsControl.ItemContainerTransitions.

Les animations de transition jouent un rôle particulier dans la conception de l’interface utilisateur de votre application. L’idée de base est qu’en cas de modification ou de transition, l’animation attire l’attention de l’utilisateur sur la modification.

Il n’est pas courant de définir la valeur de la propriété Transitions directement sur un élément UIElement qui est un élément direct de l’interface utilisateur de l’application. Il est plus courant qu’une collection de transitions fait partie d’un état visuel, d’un modèle ou d’un style. Dans ce cas, vous utilisez des mécanismes tels que Setter d’un style pour spécifier la propriété Transitions et définir la valeur à l’aide du contenu défini par XAML qui est généralement stocké en tant que ressource XAML.

VisualTransition ne fait pas partie des types que vous placez dans la collection UIElement.Transitions. VisualTransition est spécifiquement destiné aux animations dans les groupes d’états visuels et est utilisé par la propriété VisualStateGroup.Transitions .

Voir aussi

• TransitionCollection
• Animations dans une table de montage séquentiel