Android APIs
public class

MoveImage

extends Transition
java.lang.Object
   ↳ android.transition.Transition
     ↳ android.transition.MoveImage

Class Overview

Transitions ImageViews, including size, scaleType, and matrix. The ImageView drawable must remain the same between both start and end states, but the setScaleType(android.widget.ImageView.ScaleType) may differ.

Summary

[Expand]
Inherited XML Attributes
From class android.transition.Transition
[Expand]
Inherited Constants
From class android.transition.Transition
Public Constructors
MoveImage()
Public Methods
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.
Transition clone()
Creates and returns a copy of this Object.
Animator createAnimator(ViewGroup sceneRoot, TransitionValues startValues, TransitionValues endValues)
Creates an Animator for ImageViews moving, changing dimensions, and/or changing ImageView.ScaleType.
String[] getTransitionProperties()
Returns the set of property names used stored in the TransitionValues object passed into captureStartValues(TransitionValues) that this transition cares about for the purposes of canceling overlapping animations.
[Expand]
Inherited Methods
From class android.transition.Transition
From class java.lang.Object

Public Constructors

public MoveImage ()

Public Methods

public void captureEndValues (TransitionValues transitionValues)

Captures the values in the end scene for the properties that this transition monitors. These values are then passed as the endValues structure in a later call to 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 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.

Parameters
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.

public void captureStartValues (TransitionValues transitionValues)

Captures the values in the start scene for the properties that this transition monitors. These values are then passed as the startValues structure in a later call to 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 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.

Parameters
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.

public Transition clone ()

Creates and returns a copy of this Object. The default implementation returns a so-called "shallow" copy: It creates a new instance of the same class and then copies the field values (including object references) from this instance to the new instance. A "deep" copy, in contrast, would also recursively clone nested objects. A subclass that needs to implement this kind of cloning should call super.clone() to create the new instance and then create deep copies of the nested, mutable objects.

Returns
  • a copy of this object.

public Animator createAnimator (ViewGroup sceneRoot, TransitionValues startValues, TransitionValues endValues)

Creates an Animator for ImageViews moving, changing dimensions, and/or changing ImageView.ScaleType.

Parameters
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.
Returns
  • An Animator to move an ImageView or null if the View is not an ImageView, the Drawable changed, the View is not VISIBLE, or there was no change.

public String[] getTransitionProperties ()

Returns the set of property names used stored in the TransitionValues object passed into captureStartValues(TransitionValues) that this transition cares about for the purposes of canceling overlapping animations. When any transition is started on a given scene root, all transitions currently running on that same scene root are checked to see whether the properties on which they based their animations agree with the end values of the same properties in the new transition. If the end values are not equal, then the old animation is canceled since the new transition will start a new animation to these new values. If the values are equal, the old animation is allowed to continue and no new animation is started for that transition.

A transition does not need to override this method. However, not doing so will mean that the cancellation logic outlined in the previous paragraph will be skipped for that transition, possibly leading to artifacts as old transitions and new transitions on the same targets run in parallel, animating views toward potentially different end values.

Returns
  • An array of property names as described in the class documentation for TransitionValues. The default implementation returns null.