TransitionSet

open class TransitionSet : Transition
kotlin.Any
   ↳ androidx.transition.Transition
   ↳ androidx.transition.TransitionSet

A TransitionSet is a parent of child transitions (including other TransitionSets). Using TransitionSets enables more complex choreography of transitions, where some sets play #ORDERING_TOGETHER and others play #ORDERING_SEQUENTIAL. For example, AutoTransition uses a TransitionSet to sequentially play a Fade(Fade.OUT), followed by a ChangeBounds, followed by a Fade(Fade.OUT) transition.

A TransitionSet can be described in a resource file by using the tag transitionSet, along with the standard attributes of TransitionSet and Transition. Child transitions of the TransitionSet object can be loaded by adding those child tags inside the enclosing transitionSet tag. For example, the following xml describes a TransitionSet that plays a Fade and then a ChangeBounds transition on the affected view targets:

 <transitionSet xmlns:android="http://schemas.android.com/apk/res/android" android:transitionOrdering="sequential"> <fade/> <changeBounds/> </transitionSet> 

Summary

Constants
static Int

A flag used to indicate that the child transitions of this set should play in sequence; when one child transition ends, the next child transition begins.

static Int

A flag used to indicate that the child transitions of this set should all start at the same time.

Inherited constants
Public constructors

Constructs an empty transition set.

<init>(context: Context!, attrs: AttributeSet!)

Public methods
open TransitionSet

open TransitionSet
setStartDelay(startDelay: Long)

open Transition
excludeTarget(target: View, exclude: Boolean)

open Transition
excludeTarget(targetName: String, exclude: Boolean)

open Transition
excludeTarget(targetId: Int, exclude: Boolean)

open Transition
excludeTarget(type: Class<Any!>, exclude: Boolean)

open TransitionSet

open TransitionSet

Adds child transition to this set.

open Unit

open Transition

open Int

Returns the ordering of this TransitionSet.

open TransitionSet
setOrdering(ordering: Int)

Sets the play order of this set's child transitions.

open Transition!

Returns the child Transition at the specified position in the TransitionSet.

open TransitionSet

open Int

Returns the number of child transitions in the TransitionSet.

open Unit

open TransitionSet
addTarget(target: View)

open TransitionSet
addTarget(targetId: Int)

open TransitionSet
addTarget(targetName: String)

open TransitionSet
addTarget(targetType: Class<Any!>)

open Unit

open TransitionSet
setDuration(duration: Long)

Setting a non-negative duration on a TransitionSet causes all of the child transitions (current and future) to inherit this duration.

open Unit

open TransitionSet

Removes the specified child transition from this set.

open TransitionSet
removeTarget(targetId: Int)

open TransitionSet
removeTarget(target: View)

open TransitionSet
removeTarget(target: Class<Any!>)

open TransitionSet

open Unit
setPathMotion(pathMotion: PathMotion?)

Inherited functions

Constants

ORDERING_SEQUENTIAL

static val ORDERING_SEQUENTIAL: Int

A flag used to indicate that the child transitions of this set should play in sequence; when one child transition ends, the next child transition begins. Note that a transition does not end until all instances of it (which are playing on all applicable targets of the transition) end.

Value: 1

ORDERING_TOGETHER

static val ORDERING_TOGETHER: Int

A flag used to indicate that the child transitions of this set should all start at the same time.

Value: 0

Public constructors

<init>

TransitionSet()

Constructs an empty transition set. Add child transitions to the set by calling #addTransition(Transition) )}. By default, child transitions will play together.

<init>

TransitionSet(context: Context!, attrs: AttributeSet!)

Public methods

addListener

open fun addListener(listener: Transition.TransitionListener): TransitionSet

setStartDelay

open fun setStartDelay(startDelay: Long): TransitionSet

excludeTarget

open fun excludeTarget(target: View, exclude: Boolean): Transition

excludeTarget

open fun excludeTarget(targetName: String, exclude: Boolean): Transition

excludeTarget

open fun excludeTarget(targetId: Int, exclude: Boolean): Transition

excludeTarget

open fun excludeTarget(type: Class<Any!>, exclude: Boolean): Transition

removeListener

open fun removeListener(listener: Transition.TransitionListener): TransitionSet

addTransition

open fun addTransition(transition: Transition): TransitionSet

Adds child transition to this set. The order in which this child transition is added relative to other child transitions that are added, in addition to the ordering property, determines the order in which the transitions are started.

If this transitionSet has a duration, interpolator, propagation delay, path motion, or epicenter callback set on it, the child transition will inherit the values that are set. Transitions are assumed to have a maximum of one transitionSet parent.

Parameters
transition Transition: A non-null child transition to be added to this set.
Return
TransitionSet: This transitionSet object.

setPropagation

open fun setPropagation(propagation: TransitionPropagation?): Unit

clone

open fun clone(): Transition

getOrdering

open fun getOrdering(): Int

Returns the ordering of this TransitionSet. By default, the value is #ORDERING_TOGETHER.

Return
Int: #ORDERING_TOGETHER if child transitions will play at the same time, #ORDERING_SEQUENTIAL if they will play in sequence.

setOrdering

open fun setOrdering(ordering: Int): TransitionSet

Sets the play order of this set's child transitions.

Parameters
ordering Int: #ORDERING_TOGETHER to play this set's child transitions together, #ORDERING_SEQUENTIAL to play the child transitions in sequence.
Return
TransitionSet: This transitionSet object.

getTransitionAt

open fun getTransitionAt(index: Int): Transition!

Returns the child Transition at the specified position in the TransitionSet.

Parameters
index Int: The position of the Transition to retrieve.

setInterpolator

open fun setInterpolator(interpolator: TimeInterpolator?): TransitionSet

getTransitionCount

open fun getTransitionCount(): Int

Returns the number of child transitions in the TransitionSet.

Return
Int: The number of child transitions in the TransitionSet.

setEpicenterCallback

open fun setEpicenterCallback(epicenterCallback: Transition.EpicenterCallback?): Unit

addTarget

open fun addTarget(target: View): TransitionSet

addTarget

open fun addTarget(targetId: Int): TransitionSet

addTarget

open fun addTarget(targetName: String): TransitionSet

addTarget

open fun addTarget(targetType: Class<Any!>): TransitionSet

captureStartValues

open fun captureStartValues(transitionValues: TransitionValues): Unit

setDuration

open fun setDuration(duration: Long): TransitionSet

Setting a non-negative duration on a TransitionSet causes all of the child transitions (current and future) to inherit this duration.

Parameters
duration Long: The length of the animation, in milliseconds.
Return
TransitionSet: This transitionSet object.

captureEndValues

open fun captureEndValues(transitionValues: TransitionValues): Unit

removeTransition

open fun removeTransition(transition: Transition): TransitionSet

Removes the specified child transition from this set.

Parameters
transition Transition: The transition to be removed.
Return
TransitionSet: This transitionSet object.

removeTarget

open fun removeTarget(targetId: Int): TransitionSet

removeTarget

open fun removeTarget(target: View): TransitionSet

removeTarget

open fun removeTarget(target: Class<Any!>): TransitionSet

removeTarget

open fun removeTarget(target: String): TransitionSet

setPathMotion

open fun setPathMotion(pathMotion: PathMotion?): Unit