com.bluelinelabs.conductor.changehandler

Class TransitionChangeHandler

java.lang.Object

com.bluelinelabs.conductor.ControllerChangeHandler

com.bluelinelabs.conductor.changehandler.TransitionChangeHandler

Direct Known Subclasses:

AutoTransitionChangeHandler, SharedElementTransitionChangeHandler

public abstract class TransitionChangeHandler
extends ControllerChangeHandler

A base ControllerChangeHandler that facilitates using Transitions to replace Controller Views.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	TransitionChangeHandler.OnTransitionPreparedListener

Nested classes/interfaces inherited from class com.bluelinelabs.conductor.ControllerChangeHandler

ControllerChangeHandler.ControllerChangeCompletedListener, ControllerChangeHandler.ControllerChangeListener

Constructor Summary

Constructors

Constructor and Description
TransitionChangeHandler()

Method Summary

Modifier and Type	Method and Description
void	completeImmediately() Will be called on change handlers that push a controller if the controller being pushed is needs to be attached immediately, without any animations or transitions.
void	executePropertyChanges(android.view.ViewGroup container, android.view.View from, android.view.View to, android.transition.Transition transition, boolean isPush) This should set all view properties needed for the transition to work properly.
protected abstract android.transition.Transition	getTransition(android.view.ViewGroup container, android.view.View from, android.view.View to, boolean isPush) Should be overridden to return the Transition to use while replacing Views.
void	onAbortPush(ControllerChangeHandler newHandler, Controller newTop) Will be called on change handlers that push a controller if the controller being pushed is popped before it has completed.
void	performChange(android.view.ViewGroup container, android.view.View from, android.view.View to, boolean isPush, ControllerChangeHandler.ControllerChangeCompletedListener changeListener) Responsible for swapping Views from one Controller to another.
void	prepareForTransition(android.view.ViewGroup container, android.view.View from, android.view.View to, android.transition.Transition transition, boolean isPush, TransitionChangeHandler.OnTransitionPreparedListener onTransitionPreparedListener) Called before a transition occurs.
boolean	removesFromViewOnPush()

Methods inherited from class com.bluelinelabs.conductor.ControllerChangeHandler

copy, fromBundle, isReusable, restoreFromBundle, saveToBundle, setForceRemoveViewOnPush

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TransitionChangeHandler

public TransitionChangeHandler()

Method Detail

getTransition

protected abstract android.transition.Transition getTransition(android.view.ViewGroup container,
                                                               android.view.View from,
                                                               android.view.View to,
                                                               boolean isPush)

Should be overridden to return the Transition to use while replacing Views.

Parameters:

container - The container these Views are hosted in

from - The previous View in the container or null if there was no Controller before this transition

to - The next View that should be put in the container or null if no Controller is being transitioned to

isPush - True if this is a push transaction, false if it's a pop

onAbortPush

public void onAbortPush(ControllerChangeHandler newHandler,
                        Controller newTop)

Description copied from class: ControllerChangeHandler

Will be called on change handlers that push a controller if the controller being pushed is popped before it has completed.

Overrides:

onAbortPush in class ControllerChangeHandler

Parameters:

newHandler - The change handler that has caused this push to be aborted

newTop - The Controller that will now be at the top of the backstack or null if there will be no new Controller at the top

completeImmediately

public void completeImmediately()

Description copied from class: ControllerChangeHandler

Will be called on change handlers that push a controller if the controller being pushed is needs to be attached immediately, without any animations or transitions.

Overrides:

completeImmediately in class ControllerChangeHandler

performChange

public void performChange(android.view.ViewGroup container,
                          android.view.View from,
                          android.view.View to,
                          boolean isPush,
                          ControllerChangeHandler.ControllerChangeCompletedListener changeListener)

Description copied from class: ControllerChangeHandler

Responsible for swapping Views from one Controller to another.

Specified by:

performChange in class ControllerChangeHandler

Parameters:

container - The container these Views are hosted in.

from - The previous View in the container or null if there was no Controller before this transition

to - The next View that should be put in the container or null if no Controller is being transitioned to

isPush - True if this is a push transaction, false if it's a pop.

changeListener - This listener must be called when any transitions or animations are completed.

removesFromViewOnPush

public boolean removesFromViewOnPush()

Overrides:

removesFromViewOnPush in class ControllerChangeHandler

prepareForTransition

public void prepareForTransition(android.view.ViewGroup container,
                                 android.view.View from,
                                 android.view.View to,
                                 android.transition.Transition transition,
                                 boolean isPush,
                                 TransitionChangeHandler.OnTransitionPreparedListener onTransitionPreparedListener)

Called before a transition occurs. This can be used to reorder views, set their transition names, etc. The transition will begin when onTransitionPreparedListener is called.

Parameters:

container - The container these Views are hosted in

from - The previous View in the container or null if there was no Controller before this transition

to - The next View that should be put in the container or null if no Controller is being transitioned to

transition - The transition that is being prepared for

isPush - True if this is a push transaction, false if it's a pop

executePropertyChanges

public void executePropertyChanges(android.view.ViewGroup container,
                                   android.view.View from,
                                   android.view.View to,
                                   android.transition.Transition transition,
                                   boolean isPush)

This should set all view properties needed for the transition to work properly. By default it removes the "from" view and adds the "to" view.

Parameters:

container - The container these Views are hosted in

from - The previous View in the container or null if there was no Controller before this transition

to - The next View that should be put in the container or null if no Controller is being transitioned to

transition - The transition with which TransitionManager.beginDelayedTransition has been called. This will be null only if another ControllerChangeHandler immediately overrides this one.

isPush - True if this is a push transaction, false if it's a pop