public class Crossfade extends Transition
Note: This transition is not compatible with TextureView
or SurfaceView
.
Transition.AnimationInfo, Transition.EpicenterCallback, Transition.TransitionListener, Transition.TransitionListenerAdapter
Modifier and Type | Field and Description |
---|---|
static int |
FADE_BEHAVIOR_CROSSFADE
Flag specifying that the fading animation should cross-fade
between the old and new representation of all affected target
views.
|
static int |
FADE_BEHAVIOR_OUT_IN
Flag specifying that the fading animation should first fade
out the original representation completely and then fade in the
new one.
|
static int |
FADE_BEHAVIOR_REVEAL
Flag specifying that the fading animation should reveal the
new representation of all affected target views.
|
static int |
RESIZE_BEHAVIOR_NONE
Flag specifying that the transition should not animate any
changes in size between the old and new target views.
|
static int |
RESIZE_BEHAVIOR_SCALE
Flag specifying that the transition should animate any
changes in size between the old and new target views.
|
MATCH_ID, MATCH_INSTANCE, MATCH_ITEM_ID, MATCH_NAME
Constructor and Description |
---|
Crossfade() |
Modifier and Type | Method and Description |
---|---|
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 |
getFadeBehavior()
Returns the fading behavior of the animation.
|
int |
getResizeBehavior()
Returns the resizing behavior of the animation.
|
Crossfade |
setFadeBehavior(int fadeBehavior)
Sets the type of fading animation that will be run, one of
FADE_BEHAVIOR_CROSSFADE and FADE_BEHAVIOR_REVEAL . |
Crossfade |
setResizeBehavior(int resizeBehavior)
Sets the type of resizing behavior that will be used during the
transition animation, one of
RESIZE_BEHAVIOR_NONE and
RESIZE_BEHAVIOR_SCALE . |
addListener, addTarget, addTarget, addTarget, addTarget, animate, cancel, canRemoveViews, clone, createAnimators, end, excludeChildren, excludeChildren, excludeChildren, excludeTarget, excludeTarget, excludeTarget, excludeTarget, getDuration, getEpicenter, getEpicenterCallback, getInterpolator, getName, getNameOverrides, getPathMotion, getPropagation, getStartDelay, getTargetIds, getTargetNames, getTargets, getTargetTypes, getTargetViewNames, getTransitionProperties, getTransitionValues, isTransitionRequired, pause, removeListener, removeTarget, removeTarget, removeTarget, removeTarget, resume, runAnimators, setDuration, setEpicenterCallback, setInterpolator, setMatchOrder, setNameOverrides, setPathMotion, setPropagation, setStartDelay, start, toString
public static final int FADE_BEHAVIOR_CROSSFADE
setFadeBehavior(int)
,
Constant Field Valuespublic static final int FADE_BEHAVIOR_REVEAL
setFadeBehavior(int)
,
Constant Field Valuespublic static final int FADE_BEHAVIOR_OUT_IN
setFadeBehavior(int)
,
Constant Field Valuespublic static final int RESIZE_BEHAVIOR_NONE
setResizeBehavior(int)
,
Constant Field Valuespublic static final int RESIZE_BEHAVIOR_SCALE
setResizeBehavior(int)
,
Constant Field Valuespublic Crossfade setFadeBehavior(int fadeBehavior)
FADE_BEHAVIOR_CROSSFADE
and FADE_BEHAVIOR_REVEAL
.fadeBehavior
- The type of fading animation to use when this
transition is run.public int getFadeBehavior()
setFadeBehavior(int)
public Crossfade setResizeBehavior(int resizeBehavior)
RESIZE_BEHAVIOR_NONE
and
RESIZE_BEHAVIOR_SCALE
.resizeBehavior
- The type of resizing behavior to use when this
transition is run.public int getResizeBehavior()
setResizeBehavior(int)
public Animator createAnimator(ViewGroup sceneRoot, TransitionValues startValues, 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.public void captureStartValues(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(android.view.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)
public void captureEndValues(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(android.view.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)