ConnectedAnimation Classe

Définition

Espace de noms:

Windows.UI.Xaml.Media.Animation

Représente une animation qui anime simultanément la sortie d’un élément et l’entrée d’un autre élément.

public ref class ConnectedAnimation sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectedAnimation final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectedAnimation

Public NotInheritable Class ConnectedAnimation

Héritage

Object Platform::Object IInspectable ConnectedAnimation

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Animation connectée.

Si vous avez installé l’application Galerie WinUI 2 , cliquez ici pour ouvrir l’application et voir Animation connectée en action.

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

Remarques

Un instance ConnectedAnimation est retourné par les méthodes ConnectedAnimationService.GetAnimation et ConnectedAnimationService.PrepareToAnimate.

Lorsque vous appelez TryStart, la taille de l’élément que vous passez à la méthode doit être définie dans la disposition. Cela signifie que soit la taille de l’élément doit être définie dans le balisage, soit le contenu de l’élément doit être entièrement rempli, afin que sa taille puisse être calculée par l’infrastructure XAML. Si la disposition fait partie d’un élément ListView ou GridView avec des propriétés liées, vous devrez peut-être mettre à jour manuellement le contenu pour préparer l’animation, car les liaisons peuvent être mises à jour de manière asynchrone.

Il existe une limitation connue dans laquelle ConnectedAnimation ne fonctionne pas correctement avec les transitions de thème qui ont un composant de traduction, y compris NavigationThemeTransition et EntranceThemeTransition. Nous vous recommandons de supprimer ces transitions ou de supprimer la navigation à l’aide de SuppressNavigationTransitionInfo lorsque vous créez une expérience avec ConnectedAnimation.

Consultez l’exemple d’animation connectée pour obtenir un exemple complet de ConnectedAnimation.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1703	15063	IsScaleAnimationEnabled
1703	15063	SetAnimationComponent
1703	15063	TryStart(UIElement,IEnumerable<UIElement>)
1809	17763	Configuration

Propriétés

Configuration	Obtient ou définit la configuration qui décrit le type d’animation connectée à lire.
IsScaleAnimationEnabled	Obtient ou définit une valeur qui indique si le composant de mise à l’échelle de l’animation connectée doit être utilisé.

Méthodes

Cancel()	Arrête l’animation connectée.
SetAnimationComponent(ConnectedAnimationComponent, ICompositionAnimationBase)	Définit une CompositionAnimation personnalisée pour modifier le mouvement d’une partie particulière de l’animation connectée.
TryStart(UIElement)	Tente de démarrer l’animation.
TryStart(UIElement, IIterable<UIElement>)	Tente de démarrer l’animation sur l’élément de destination et les éléments secondaires spécifiés.

Événements

Completed

Se produit lorsque l’animation est terminée.

Voir aussi

• ConnectedAnimationService