ViewPropertyAnimator

alpha

public ViewPropertyAnimator alpha (float value)

This method will cause the View's alpha property to be animated to the specified value. Animations already running on the property will be canceled.

alphaBy

public ViewPropertyAnimator alphaBy (float value)

This method will cause the View's alpha property to be animated by the specified value. Animations already running on the property will be canceled.

cancel

public void cancel ()

Cancels all property animations that are currently running or pending.

getDuration

public long getDuration ()

Returns the current duration of property animations. If the duration was set on this object, that value is returned. Otherwise, the default value of the underlying Animator is returned.

getInterpolator

public TimeInterpolator getInterpolator ()

Returns the timing interpolator that this animation uses.

getStartDelay

public long getStartDelay ()

Returns the current startDelay of property animations. If the startDelay was set on this object, that value is returned. Otherwise, the default value of the underlying Animator is returned.

rotation

public ViewPropertyAnimator rotation (float value)

This method will cause the View's rotation property to be animated to the specified value. Animations already running on the property will be canceled.

rotationBy

public ViewPropertyAnimator rotationBy (float value)

This method will cause the View's rotation property to be animated by the specified value. Animations already running on the property will be canceled.

rotationX

public ViewPropertyAnimator rotationX (float value)

This method will cause the View's rotationX property to be animated to the specified value. Animations already running on the property will be canceled.

rotationXBy

public ViewPropertyAnimator rotationXBy (float value)

This method will cause the View's rotationX property to be animated by the specified value. Animations already running on the property will be canceled.

rotationY

public ViewPropertyAnimator rotationY (float value)

This method will cause the View's rotationY property to be animated to the specified value. Animations already running on the property will be canceled.

rotationYBy

public ViewPropertyAnimator rotationYBy (float value)

This method will cause the View's rotationY property to be animated by the specified value. Animations already running on the property will be canceled.

scaleX

public ViewPropertyAnimator scaleX (float value)

This method will cause the View's scaleX property to be animated to the specified value. Animations already running on the property will be canceled.

scaleXBy

public ViewPropertyAnimator scaleXBy (float value)

This method will cause the View's scaleX property to be animated by the specified value. Animations already running on the property will be canceled.

scaleY

public ViewPropertyAnimator scaleY (float value)

This method will cause the View's scaleY property to be animated to the specified value. Animations already running on the property will be canceled.

scaleYBy

public ViewPropertyAnimator scaleYBy (float value)

This method will cause the View's scaleY property to be animated by the specified value. Animations already running on the property will be canceled.

setDuration

public ViewPropertyAnimator setDuration (long duration)

Sets the duration for the underlying animator that animates the requested properties. By default, the animator uses the default value for ValueAnimator. Calling this method will cause the declared value to be used instead.

setInterpolator

public ViewPropertyAnimator setInterpolator (TimeInterpolator interpolator)

Sets the interpolator for the underlying animator that animates the requested properties. By default, the animator uses the default interpolator for ValueAnimator. Calling this method will cause the declared object to be used instead.

setListener

public ViewPropertyAnimator setListener (Animator.AnimatorListener listener)

Sets a listener for events in the underlying Animators that run the property animations.

setStartDelay

public ViewPropertyAnimator setStartDelay (long startDelay)

Sets the startDelay for the underlying animator that animates the requested properties. By default, the animator uses the default value for ValueAnimator. Calling this method will cause the declared value to be used instead.

setUpdateListener

public ViewPropertyAnimator setUpdateListener (ValueAnimator.AnimatorUpdateListener listener)

Sets a listener for update events in the underlying ValueAnimator that runs the property animations. Note that the underlying animator is animating between 0 and 1 (these values are then turned into the actual property values internally by ViewPropertyAnimator). So the animator cannot give information on the current values of the properties being animated by this ViewPropertyAnimator, although the view object itself can be queried to get the current values.

start

public void start ()

Starts the currently pending property animations immediately. Calling start() is optional because all animations start automatically at the next opportunity. However, if the animations are needed to start immediately and synchronously (not at the time when the next event is processed by the hierarchy, which is when the animations would begin otherwise), then this method can be used.

translationX

public ViewPropertyAnimator translationX (float value)

This method will cause the View's translationX property to be animated to the specified value. Animations already running on the property will be canceled.

translationXBy

public ViewPropertyAnimator translationXBy (float value)

This method will cause the View's translationX property to be animated by the specified value. Animations already running on the property will be canceled.

translationY

public ViewPropertyAnimator translationY (float value)

This method will cause the View's translationY property to be animated to the specified value. Animations already running on the property will be canceled.

translationYBy

public ViewPropertyAnimator translationYBy (float value)

This method will cause the View's translationY property to be animated by the specified value. Animations already running on the property will be canceled.

translationZ

public ViewPropertyAnimator translationZ (float value)

This method will cause the View's translationZ property to be animated to the specified value. Animations already running on the property will be canceled.

translationZBy

public ViewPropertyAnimator translationZBy (float value)

This method will cause the View's translationZ property to be animated by the specified value. Animations already running on the property will be canceled.

withEndAction

public ViewPropertyAnimator withEndAction (Runnable runnable)

Specifies an action to take place when the next animation ends. The action is only run if the animation ends normally; if the ViewPropertyAnimator is canceled during that animation, the runnable will not run. This method, along with withStartAction(java.lang.Runnable), is intended to help facilitate choreographing ViewPropertyAnimator animations with other animations or actions in the application.

For example, the following code animates a view to x=200 and then back to 0:

     Runnable endAction = new Runnable() {
         public void run() {
             view.animate().x(0);
         }
     };
     view.animate().x(200).withEndAction(endAction);
 

withLayer

public ViewPropertyAnimator withLayer ()

The View associated with this ViewPropertyAnimator will have its layer type set to View#LAYER_TYPE_HARDWARE for the duration of the next animation. As stated in the documentation for View#LAYER_TYPE_HARDWARE, the actual type of layer used internally depends on the runtime situation of the view. If the activity and this view are hardware-accelerated, then the layer will be accelerated as well. If the activity or the view is not accelerated, then the layer will effectively be the same as View#LAYER_TYPE_SOFTWARE.

This state is not persistent, either on the View or on this ViewPropertyAnimator: the layer type of the View will be restored when the animation ends to what it was when this method was called, and this setting on ViewPropertyAnimator is only valid for the next animation. Note that calling this method and then independently setting the layer type of the View (by a direct call to View#setLayerType(int, android.graphics.Paint)) will result in some inconsistency, including having the layer type restored to its pre-withLayer() value when the animation ends.

withStartAction

public ViewPropertyAnimator withStartAction (Runnable runnable)

Specifies an action to take place when the next animation runs. If there is a startDelay set on this ViewPropertyAnimator, then the action will run after that startDelay expires, when the actual animation begins. This method, along with withEndAction(java.lang.Runnable), is intended to help facilitate choreographing ViewPropertyAnimator animations with other animations or actions in the application.

x

public ViewPropertyAnimator x (float value)

This method will cause the View's x property to be animated to the specified value. Animations already running on the property will be canceled.

xBy

public ViewPropertyAnimator xBy (float value)

This method will cause the View's x property to be animated by the specified value. Animations already running on the property will be canceled.

y

public ViewPropertyAnimator y (float value)

This method will cause the View's y property to be animated to the specified value. Animations already running on the property will be canceled.

yBy

public ViewPropertyAnimator yBy (float value)

This method will cause the View's y property to be animated by the specified value. Animations already running on the property will be canceled.

z

public ViewPropertyAnimator z (float value)

This method will cause the View's z property to be animated to the specified value. Animations already running on the property will be canceled.

zBy

public ViewPropertyAnimator zBy (float value)

This method will cause the View's z property to be animated by the specified value. Animations already running on the property will be canceled.