ObjectAnimationUsingKeyFrames.EnableDependentAnimation Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Media.Animation

Obtient ou définit une valeur qui déclare si les propriétés animées considérées comme des animations dépendantes doivent être autorisées à utiliser cette déclaration d’animation.

public:
 property bool EnableDependentAnimation { bool get(); void set(bool value); };

bool EnableDependentAnimation();

void EnableDependentAnimation(bool value);

public bool EnableDependentAnimation { get; set; }

var boolean = objectAnimationUsingKeyFrames.enableDependentAnimation;
objectAnimationUsingKeyFrames.enableDependentAnimation = boolean;

Public Property EnableDependentAnimation As Boolean

<ObjectAnimationUsingKeyFrames EnableDependentAnimation="bool" />

Valeur de propriété

Boolean

bool

true si l’animation peut être utilisée pour un cas d’animation dépendant. false si l’animation ne peut pas être utilisée pour un cas d’animation dépendant. La valeur par défaut est false.

Remarques

Qu’est-ce qui est considéré comme une animation dépendante ?

Les applications personnalisées que vous créez ne peuvent pas toutes s’exécuter par défaut dans une application Windows Runtime, si le système d’animations détermine qu’elles peuvent nuire aux performances de votre interface utilisateur. Les animations pour lesquelles le système détermine qu’il pourrait y avoir un impact sur les performances portent le nom d’animations dépendantes. Cela dépend, car votre animation met à jour activement et fréquemment des objets sur le thread d’interface utilisateur, qui est également l’endroit où l’entrée utilisateur actuelle et d’autres mises à jour programmatiques modifient l’interface utilisateur au moment de l’exécution.

Une animation dépendante qui consomme d’importantes ressources système sur le thread d’interface utilisateur peut dans certaines situations donner l’impression que l’application a cessé de répondre. Si votre animation entraîne la modification de la disposition ou est susceptible d’avoir une incidence sur les performances du thread d’interface utilisateur, vous devez alors activer l’animation dans votre code de façon explicite pour la voir s’exécuter. C’est là qu’entre en jeu la propriété EnableDependentAnimation sur des classes d’animation spécifiques. Utilisez cette propriété avec précaution, car en la définissant sur true , vous reconnaissez délibérément que l’animation peut ralentir d’autres opérations sur le thread d’interface utilisateur lorsqu’elle s’exécute.

Pour plus d’informations, voir Animations dans une table de montage séquentiel. Cette rubrique inclut une liste des critères d’une animation indépendante. Une animation est une animation dépendante si elle ne répond pas à au moins un de ces critères. Pour la propriété spécifique que vous envisagez d’animer, et pour les spécificités de votre animation, comparez votre animation prévue aux critères pour voir si elle serait considérée comme dépendante ou indépendante par le système.

Une autre façon de déterminer si vos animations sont dépendantes consiste à recevoir un avertissement de votre aire de conception XAML ou de votre outil après avoir composé cette animation, et l’avertissement indique que vous devez définir EnableDependentAnimation sur true pour voir votre exécution d’animation.

En tant que développeur d’application, vous pouvez également choisir d’appliquer un paramètre pour toute l’application qui désactive toujours les animations dépendantes, même celles où la propriété EnableDependentAnimation a la valeur true. Voir Timeline.AllowDependentAnimations. Cela vous est utile en tant que développeur d’applications si vous consommez des contrôles où les modèles ont des animations dépendantes, et que vous avez identifié cela comme un problème de performances, mais que vous ne souhaitez pas avoir à réémoder l’ensemble du contrôle pour désactiver ces animations.

Voir aussi

• Animations dans une table de montage séquentiel
• Animations dans une table de montage séquentiel pour les états visuels