LayoutTransition Classe

Définition

Espace de noms:

Android.Animation

Assembly:

Mono.Android.dll

Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup.

[Android.Runtime.Register("android/animation/LayoutTransition", DoNotGenerateAcw=true)]
public class LayoutTransition : Java.Lang.Object

[<Android.Runtime.Register("android/animation/LayoutTransition", DoNotGenerateAcw=true)>]
type LayoutTransition = class
    inherit Object

Héritage

Object

Object

LayoutTransition

Attributs

RegisterAttribute

Remarques

Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. Pour activer les transitions pour un conteneur de disposition, créez un objet LayoutTransition et définissez-le sur n’importe quel ViewGroup en appelant ViewGroup#setLayoutTransition(LayoutTransition). Cela entraîne l’exécution d’animations par défaut chaque fois que des éléments sont ajoutés ou supprimés de ce conteneur. Pour spécifier des animations personnalisées, utilisez la LayoutTransition#setAnimator(int, Animator) setAnimator() méthode.

L’un des principaux concepts de ces animations de transition est qu’il existe deux types de modifications qui provoquent la transition et quatre animations différentes qui s’exécutent en raison de ces modifications. Les modifications qui déclenchent la transition sont des éléments ajoutés à un conteneur (appelé transition « apparaissant ») ou supprimés d’un conteneur (également appelé « disparition »). La définition de la visibilité des vues (entre GONE et VISIBLE) déclenche la même logique d’ajout/suppression. Les animations qui s’exécutent en raison de ces événements sont une animation qui anime les éléments ajoutés, une qui anime les éléments supprimés et deux qui animent les autres éléments du conteneur qui changent en raison de l’occurrence d’ajout/suppression. Les utilisateurs de la transition peuvent souhaiter des animations différentes pour les éléments changeants selon qu’ils changent en raison d’un événement d’apparition ou de disparition. Il existe donc une animation pour chacune de ces variantes de l’événement changeant. La plupart de l’API de cette classe concerne la configuration des propriétés de base des animations utilisées dans ces quatre situations, ou la configuration d’animations personnalisées pour l’une ou l’autre des quatre.

Par défaut, l’animation DISAPPEARING commence immédiatement, comme le fait l’animation CHANGE_APPEARING. Les autres animations commencent après un délai défini sur la durée par défaut des animations. Ce comportement facilite une séquence d’animations en transitions comme suit : lorsqu’un élément est ajouté à une disposition, les autres enfants de ce conteneur se déplacent en premier (créant ainsi de l’espace pour le nouvel élément), puis l’animation qui apparaît s’exécute pour animer l’élément ajouté. À l’inverse, lorsqu’un élément est supprimé d’un conteneur, l’animation à supprimer s’exécute en premier, puis les animations des autres enfants de la disposition s’exécutent (fermant l’écart créé dans la disposition lorsque l’élément a été supprimé). Si ce comportement de chorégraphie par défaut n’est pas souhaité, l’une #setDuration(int, long) #setStartDelay(int, long) ou l’autre des animations peut être modifiée selon les besoins. Gardez à l’esprit toutefois que si vous démarrez une animation APPEARING avant la fin d’une animation DISAPPEARING, l’animation DISAPPEARING s’arrête et tous les effets de l’animation DISAPPEARING sont rétablis. Si vous démarrez plutôt une animation DISAPPEARING avant la fin d’une animation APPEARING, un ensemble similaire d’effets se produit pour l’animation APPEARING.

Les animations spécifiées pour la transition, les valeurs par défaut et toutes les animations personnalisées définies sur l’objet de transition, sont des modèles uniquement. Autrement dit, ces animations existent pour contenir les propriétés d’animation de base, telles que la durée, le délai de début et les propriétés animées. Toutefois, l’objet cible réel, ainsi que les valeurs de début et de fin de ces propriétés, sont définies automatiquement dans le processus de configuration de la transition chaque fois qu’elle s’exécute. Chacune des animations est clonées à partir de la copie d’origine et le clone est ensuite rempli avec les valeurs dynamiques de la cible animées (par exemple, l’un des éléments d’un conteneur de disposition qui se déplace à la suite de l’événement de disposition) ainsi que les valeurs qui changent (telles que la position et la taille de cet objet). Les valeurs réelles envoyées à chaque animation dépendent des propriétés spécifiées pour l’animation. Par exemple, l’animation CHANGE_APPEARING par défaut anime les leftpropriétés , , toprightbottom, et scrollXscrollY les propriétés. Les valeurs de ces propriétés sont mises à jour avec les valeurs de pré-disposition et de post-disposition lorsque la transition commence. Les animations personnalisées sont également remplies avec la cible et les valeurs animées, en supposant qu’elles utilisent des objets ObjectAnimator avec des noms de propriétés connus sur l’objet cible.

Cette classe et l’indicateur XML associé pour les conteneurs, animateLayoutChanges="true », fournit un utilitaire simple destiné à automatiser les modifications dans des situations simples. L’utilisation de LayoutTransition à plusieurs niveaux d’une hiérarchie de vues imbriquées peut ne pas fonctionner en raison de l’interconnexion des différents niveaux de disposition. En outre, un conteneur en cours de défilement en même temps que les éléments sont ajoutés ou supprimés n’est probablement pas un bon candidat pour cet utilitaire, car les emplacements avant/après calculés par LayoutTransition peuvent ne pas correspondre aux emplacements réels lorsque les animations se terminent en raison du défilement du conteneur lorsque les animations sont en cours d’exécution. Vous pouvez contourner ce problème en désactivant les animations « changeant » en définissant les animations CHANGE_APPEARING et CHANGE_DISAPPEARING sur Null, et en définissant correctement startDelay des autres animations.

Documentation Java pour android.animation.LayoutTransition.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Constructeurs

LayoutTransition()	Construit un objet LayoutTransition.
LayoutTransition(IntPtr, JniHandleOwnership)	Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime.

Champs

Appearing	Obsolète. Indicateur indiquant l’animation qui s’exécute sur ces éléments qui apparaissent dans le conteneur.
ChangeAppearing	Obsolète. Indicateur indiquant l’animation qui s’exécute sur ces éléments qui changent en raison d’un nouvel élément apparaissant dans le conteneur.
ChangeDisappearing	Obsolète. Indicateur indiquant l’animation qui s’exécute sur ces éléments qui changent en raison d’un élément qui disparaît du conteneur.
Changing	Obsolète. Indicateur indiquant l’animation qui s’exécute sur ces éléments qui changent en raison d’une modification de disposition non due à l’ajout ou à la suppression d’éléments du conteneur.
Disappearing	Obsolète. Indicateur indiquant l’animation qui s’exécute sur ces éléments qui disparaissent du conteneur.

Propriétés

Class	Retourne la classe runtime de ce Object. (Hérité de Object)
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
IsChangingLayout	Retourne la valeur true si les animations sont en cours d’exécution qui animent les propriétés liées à la disposition.
IsRunning	Retourne true si l’une des animations de cette transition est en cours d’exécution.
JniIdentityHashCode	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
JniPeerMembers	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup.
PeerReference	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
ThresholdClass	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.
ThresholdType	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.
TransitionListeners	Obtient la liste actuelle des écouteurs pour les modifications de disposition.

Méthodes

AddChild(ViewGroup, View)	Cette méthode est appelée par ViewGroup lorsqu’une vue enfant est sur le point d’être ajoutée au conteneur.
AddTransitionListener(LayoutTransition+ITransitionListener)	Ajoutez un écouteur qui sera appelé lorsque les limites de la vue changent en raison du traitement de la disposition.
Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
DisableTransitionType(LayoutTransitionType)	Désactive le transitionType spécifié pour cet objet LayoutTransition.
Dispose()	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
Dispose(Boolean)	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
EnableTransitionType(LayoutTransitionType)	Active le transitionType spécifié pour cet objet LayoutTransition.
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
GetAnimator(LayoutTransitionType)	Obtient l’animation utilisée pendant l’un des types de transition qui peuvent s’exécuter.
GetDuration(LayoutTransitionType)	Obtient la durée de l’un des objets d’animation utilisés par cette transition.
GetHashCode()	Retourne une valeur de code de hachage pour l'objet. (Hérité de Object)
GetInterpolator(LayoutTransitionType)	Obtient l’interpolateur sur l’un des objets d’animation utilisés par cette transition.
GetStagger(LayoutTransitionType)	Obtient la durée de délai entre le démarrage de chaque animation pendant l’une des animations de modification.
GetStartDelay(LayoutTransitionType)	Obtient le délai de début sur l’un des objets d’animation utilisés par cette transition.
HideChild(ViewGroup, View, ViewStates)	Cette méthode est appelée par ViewGroup lorsqu’une vue enfant est sur le point d’être masquée dans le conteneur.
HideChild(ViewGroup, View)	Obsolète. Ce membre est déconseillé.
IsTransitionTypeEnabled(LayoutTransitionType)	Retourne si la transitionType spécifiée est activée pour cet objet LayoutTransition.
JavaFinalize()	Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
RemoveChild(ViewGroup, View)	Cette méthode est appelée par ViewGroup lorsqu’une vue enfant est sur le point d’être supprimée du conteneur.
RemoveTransitionListener(LayoutTransition+ITransitionListener)	Supprimez un écouteur pour les modifications de disposition.
SetAnimateParentHierarchy(Boolean)	Cet indicateur contrôle si CHANGE_APPEARING ou CHANGE_DISAPPEARING animations entraîne l’exécution de l’animation par défaut de modification sur la hiérarchie parente.
SetAnimator(LayoutTransitionType, Animator)	Définit l’animation utilisée pendant l’un des types de transition qui peuvent s’exécuter.
SetDuration(Int64)	Définit la durée à utiliser par toutes les animations de cet objet de transition.
SetDuration(LayoutTransitionType, Int64)	Définit la durée sur l’un des objets d’animation utilisés par cette transition.
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
SetInterpolator(LayoutTransitionType, ITimeInterpolator)	Définit l’interpolateur sur l’un des objets d’animation utilisés par cette transition.
SetStagger(LayoutTransitionType, Int64)	Définit la durée de délai entre le démarrage de chaque animation pendant l’une des animations de modification.
SetStartDelay(LayoutTransitionType, Int64)	Définit le délai de début sur l’un des objets d’animation utilisés par cette transition.
ShowChild(ViewGroup, View, ViewStates)	Cette méthode est appelée par ViewGroup lorsqu’une vue enfant est sur le point d’être rendue visible dans le conteneur.
ShowChild(ViewGroup, View)	Obsolète. Ce membre est déconseillé.
ToArray<T>()	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
ToString()	Retourne une représentation de chaîne de l'objet. (Hérité de Object)
UnregisterFromRuntime()	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou> <em>interrompu</em>.<> (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)

Événements

EndTransition	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup.
StartTransition	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup.

Implémentations d’interfaces explicites

IJavaPeerable.Disposed()	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
IJavaPeerable.DisposeUnlessReferenced()	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
IJavaPeerable.Finalized()	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
IJavaPeerable.JniManagedPeerState	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup. (Hérité de Object)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup.
GetJniTypeName(IJavaPeerable)	Cette classe active les animations automatiques sur les modifications de disposition dans les objets ViewGroup.