UIElement.Transitions Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient ou définit la collection d’éléments de style Transition qui s’appliquent à un 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.

Ouvrez l’application Galerie WinUI 3 et voyez les transitions en action.

L’application WinUI 3 Gallery comprend des exemples interactifs de la plupart des contrôles et des fonctionnalités WinUI 3. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

L’exemple XAML suivant 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 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.

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 que lorsqu’il y a un changement ou une transition, l’animation attire l’attention de l’utilisateur sur la modification.

Il n’est pas courant de définir la valeur de la Transitions propriété directement sur un élément UIElement qui est un élément direct de l’interface utilisateur d’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é et définir la valeur à l’aide Transitions du contenu défini par XAML qui est généralement stocké en tant que ressource XAML.

VisualTransition n’est pas l’un des types que vous placez dans la UIElement.Transitions collection. 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