public class TransitionSet extends Transition
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.
Unlike the platform version, this does not support declaration by XML resources.
Transition.TransitionListener
Modifier and Type | Field and Description |
---|---|
static int |
ORDERING_SEQUENTIAL
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 |
ORDERING_TOGETHER
A flag used to indicate that the child transitions of this set
should all start at the same time.
|
Constructor and Description |
---|
TransitionSet()
Constructs an empty transition set.
|
Modifier and Type | Method and Description |
---|---|
TransitionSet |
addTransition(Transition transition)
Adds child transition to this set.
|
void |
captureEndValues(TransitionValues transitionValues)
Captures the values in the end scene for the properties that this
transition monitors.
|
void |
captureStartValues(TransitionValues transitionValues)
Captures the values in the start scene for the properties that this
transition monitors.
|
Animator |
createAnimator(ViewGroup sceneRoot,
TransitionValues startValues,
TransitionValues endValues)
This method creates an animation that will be run for this transition
given the information in the startValues and endValues structures captured
earlier for the start and end scenes.
|
int |
getOrdering()
Returns the ordering of this TransitionSet.
|
TransitionSet |
removeTransition(Transition transition)
Removes the specified child transition from this set.
|
TransitionSet |
setOrdering(int ordering)
Sets the play order of this set's child transitions.
|
addListener, addTarget, addTarget, excludeChildren, excludeChildren, excludeChildren, excludeTarget, excludeTarget, excludeTarget, getDuration, getInterpolator, getName, getStartDelay, getTargetIds, getTargets, getTransitionProperties, getTransitionValues, removeListener, removeTarget, removeTarget, setDuration, setInterpolator, setStartDelay, toString
public static final int ORDERING_TOGETHER
public static final int ORDERING_SEQUENTIAL
public TransitionSet()
addTransition(Transition)
)}. By default,
child transitions will play together
.public int getOrdering()
ORDERING_TOGETHER
.ORDERING_TOGETHER
if child transitions will play at the same
time, ORDERING_SEQUENTIAL
if they will play in sequence.setOrdering(int)
@NonNull public TransitionSet setOrdering(int ordering)
ordering
- ORDERING_TOGETHER
to play this set's child
transitions together, ORDERING_SEQUENTIAL
to play the child
transitions in sequence.@NonNull public TransitionSet addTransition(@NonNull Transition transition)
ordering
property, determines the
order in which the transitions are started.
If this transitionSet has a duration
set on it, the
child transition will inherit that duration. Transitions are assumed to have
a maximum of one transitionSet parent.
transition
- A non-null child transition to be added to this set.@NonNull public TransitionSet removeTransition(@NonNull Transition transition)
transition
- The transition to be removed.public void captureEndValues(@NonNull TransitionValues transitionValues)
Transition
Transition.createAnimator(ViewGroup, TransitionValues, TransitionValues)
.
The main concern for an implementation is what the
properties are that the transition cares about and what the values are
for all of those properties. The start and end values will be compared
later during the
Transition.createAnimator(ViewGroup, TransitionValues, TransitionValues)
method to determine what, if any, animations, should be run.
Subclasses must implement this method. The method should only be called by the transition system; it is not intended to be called from external classes.
captureEndValues
in class Transition
transitionValues
- The holder for any values that the Transition
wishes to store. Values are stored in the values
field
of this TransitionValues object and are keyed from
a String value. For example, to store a view's rotation value,
a transition might call
transitionValues.values.put("appname:transitionname:rotation",
view.getRotation())
. The target view will already be stored
in
the transitionValues structure when this method is called.Transition.captureStartValues(TransitionValues)
,
Transition.createAnimator(ViewGroup, TransitionValues, TransitionValues)
public void captureStartValues(@NonNull TransitionValues transitionValues)
Transition
Transition.createAnimator(ViewGroup, TransitionValues, TransitionValues)
.
The main concern for an implementation is what the
properties are that the transition cares about and what the values are
for all of those properties. The start and end values will be compared
later during the
Transition.createAnimator(ViewGroup, TransitionValues, TransitionValues)
method to determine what, if any, animations, should be run.
Subclasses must implement this method. The method should only be called by the transition system; it is not intended to be called from external classes.
captureStartValues
in class Transition
transitionValues
- The holder for any values that the Transition
wishes to store. Values are stored in the values
field
of this TransitionValues object and are keyed from
a String value. For example, to store a view's rotation value,
a transition might call
transitionValues.values.put("appname:transitionname:rotation",
view.getRotation())
. The target view will already be stored
in
the transitionValues structure when this method is called.Transition.captureEndValues(TransitionValues)
,
Transition.createAnimator(ViewGroup, TransitionValues, TransitionValues)
@Nullable public Animator createAnimator(@NonNull ViewGroup sceneRoot, @NonNull TransitionValues startValues, @NonNull TransitionValues endValues)
Transition
This method is called by the transition's parent (all the way up to the
topmost Transition in the hierarchy) with the sceneRoot and start/end
values that the transition may need to set up initial target values
and construct an appropriate animation. For example, if an overall
Transition is a TransitionSet
consisting of several
child transitions in sequence, then some of the child transitions may
want to set initial values on target views prior to the overall
Transition commencing, to put them in an appropriate state for the
delay between that start and the child Transition start time. For
example, a transition that fades an item in may wish to set the starting
alpha value to 0, to avoid it blinking in prior to the transition
actually starting the animation. This is necessary because the scene
change that triggers the Transition will automatically set the end-scene
on all target views, so a Transition that wants to animate from a
different value should set that value prior to returning from this method.
Additionally, a Transition can perform logic to determine whether the transition needs to run on the given target and start/end values. For example, a transition that resizes objects on the screen may wish to avoid running for views which are not present in either the start or end scenes.
If there is an animator created and returned from this method, the
transition mechanism will apply any applicable duration, startDelay,
and interpolator to that animation and start it. A return value of
null
indicates that no animation should run. The default
implementation returns null.
The method is called for every applicable target object, which is
stored in the TransitionValues.view
field.
createAnimator
in class Transition
sceneRoot
- The root of the transition hierarchy.startValues
- The values for a specific target in the start scene.endValues
- The values for the target in the end scene.