com.bluelinelabs.conductor.changehandler

Class TransitionChangeHandlerCompat

java.lang.Object

com.bluelinelabs.conductor.ControllerChangeHandler

com.bluelinelabs.conductor.changehandler.TransitionChangeHandlerCompat

public class TransitionChangeHandlerCompat
extends ControllerChangeHandler

A base ControllerChangeHandler that facilitates using Transitions to replace Controller Views. If the target device is running on a version of Android that doesn't support transitions, a fallback ControllerChangeHandler will be used.

Nested Class Summary

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

ControllerChangeHandler.ControllerChangeCompletedListener, ControllerChangeHandler.ControllerChangeListener

Constructor Summary

Constructors

Constructor and Description
TransitionChangeHandlerCompat()
TransitionChangeHandlerCompat(TransitionChangeHandler transitionChangeHandler, ControllerChangeHandler fallbackChangeHandler) Constructor that takes a TransitionChangeHandler for use with compatible devices, as well as a fallback ControllerChangeHandler for use with older devices.

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.
ControllerChangeHandler	copy() Returns a copy of this ControllerChangeHandler.
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.
boolean	removesFromViewOnPush()
void	restoreFromBundle(android.os.Bundle bundle) Restores data that was saved in the ControllerChangeHandler.saveToBundle(Bundle bundle) method.
void	saveToBundle(android.os.Bundle bundle) Saves any data about this handler to a Bundle in case the application is killed.
void	setForceRemoveViewOnPush(boolean force)

Methods inherited from class com.bluelinelabs.conductor.ControllerChangeHandler

fromBundle, isReusable

Methods inherited from class java.lang.Object

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

Constructor Detail

TransitionChangeHandlerCompat

public TransitionChangeHandlerCompat()

TransitionChangeHandlerCompat

public TransitionChangeHandlerCompat(TransitionChangeHandler transitionChangeHandler,
                                     ControllerChangeHandler fallbackChangeHandler)

Constructor that takes a TransitionChangeHandler for use with compatible devices, as well as a fallback ControllerChangeHandler for use with older devices.

Parameters:

transitionChangeHandler - The change handler that will be used on API 21 and above

fallbackChangeHandler - The change handler that will be used on APIs below 21

Method Detail

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.

saveToBundle

public void saveToBundle(android.os.Bundle bundle)

Description copied from class: ControllerChangeHandler

Saves any data about this handler to a Bundle in case the application is killed.

Overrides:

saveToBundle in class ControllerChangeHandler

Parameters:

bundle - The Bundle into which data should be stored.

restoreFromBundle

public void restoreFromBundle(android.os.Bundle bundle)

Description copied from class: ControllerChangeHandler

Restores data that was saved in the ControllerChangeHandler.saveToBundle(Bundle bundle) method.

Overrides:

restoreFromBundle in class ControllerChangeHandler

Parameters:

bundle - The bundle that has data to be restored

removesFromViewOnPush

public boolean removesFromViewOnPush()

Overrides:

removesFromViewOnPush in class ControllerChangeHandler

copy

public ControllerChangeHandler copy()

Description copied from class: ControllerChangeHandler

Returns a copy of this ControllerChangeHandler. This method is internally used by the library, so ensure it will return an exact copy of your handler if overriding. If not overriding, the handler will be saved and restored from the Bundle format.

Overrides:

copy in class ControllerChangeHandler

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

setForceRemoveViewOnPush

public void setForceRemoveViewOnPush(boolean force)

Overrides:

setForceRemoveViewOnPush in class ControllerChangeHandler