# ViewPropertyAnimatorCompat
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
belongs to Maven artifact com.android.support:support-compat:28.0.0-alpha1
Summary:[Methods](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#inhmethods)\|[\[Expand All\]](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#)
# ViewPropertyAnimatorCompat
| This package is part of the Android[support library](https://developer.android.com/topic/libraries/support-library)which is no longer maintained. The support library has been superseded by[AndroidX](https://developer.android.com/jetpack/androidx)which is part of[Jetpack](https://developer.android.com/jetpack). We recommend using the AndroidX libraries in all new projects. You should also consider[migrating](https://developer.android.com/jetpack/androidx/migrate)existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library[class mappings](https://developer.android.com/jetpack/androidx/migrate/class-mappings).
`
public
final
class
ViewPropertyAnimatorCompat
`
`
extends Object
``
`
|---|----------------------------------------------------|
| java.lang.Object ||
| ↳ | android.support.v4.view.ViewPropertyAnimatorCompat |
*** ** * ** ***
## Summary
| ### Public methods ||
|-----------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[alpha](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#alpha(float))`(float value) ` This method will cause the View's`alpha`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[alphaBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#alphaBy(float))`(float value) ` This method will cause the View's`alpha`property to be animated by the specified value. |
| ` void` | ` `[cancel](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#cancel())`() ` Cancels all property animations that are currently running or pending. |
| ` long` | ` `[getDuration](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#getDuration())`() ` Returns the current duration of property animations. |
| ` `[Interpolator](https://developer.android.com/reference/android/view/animation/Interpolator.html) | ` `[getInterpolator](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#getInterpolator())`() ` Returns the timing interpolator that this animation uses. |
| ` long` | ` `[getStartDelay](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#getStartDelay())`() ` Returns the current startDelay of property animations. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[rotation](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#rotation(float))`(float value) ` This method will cause the View's`rotation`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[rotationBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#rotationBy(float))`(float value) ` This method will cause the View's`rotation`property to be animated by the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[rotationX](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#rotationX(float))`(float value) ` This method will cause the View's`rotationX`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[rotationXBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#rotationXBy(float))`(float value) ` This method will cause the View's`rotationX`property to be animated by the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[rotationY](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#rotationY(float))`(float value) ` This method will cause the View's`rotationY`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[rotationYBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#rotationYBy(float))`(float value) ` This method will cause the View's`rotationY`property to be animated by the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[scaleX](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#scaleX(float))`(float value) ` This method will cause the View's`scaleX`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[scaleXBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#scaleXBy(float))`(float value) ` This method will cause the View's`scaleX`property to be animated by the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[scaleY](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#scaleY(float))`(float value) ` This method will cause the View's`scaleY`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[scaleYBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#scaleYBy(float))`(float value) ` This method will cause the View's`scaleY`property to be animated by the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[setDuration](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#setDuration(long))`(long value) ` Sets the duration for the underlying animator that animates the requested properties. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[setInterpolator](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#setInterpolator(android.view.animation.Interpolator))`(`[Interpolator](https://developer.android.com/reference/android/view/animation/Interpolator.html)` value) ` Sets the interpolator for the underlying animator that animates the requested properties. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[setListener](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#setListener(android.support.v4.view.ViewPropertyAnimatorListener))`(`[ViewPropertyAnimatorListener](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorListener)` listener) ` Sets a listener for events in the underlying Animators that run the property animations. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[setStartDelay](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#setStartDelay(long))`(long value) ` Sets the startDelay for the underlying animator that animates the requested properties. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[setUpdateListener](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#setUpdateListener(android.support.v4.view.ViewPropertyAnimatorUpdateListener))`(`[ViewPropertyAnimatorUpdateListener](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorUpdateListener)` listener) ` Sets a listener for update events in the underlying Animator that runs the property animations. |
| ` void` | ` `[start](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#start())`() ` Starts the currently pending property animations immediately. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[translationX](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#translationX(float))`(float value) ` This method will cause the View's`translationX`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[translationXBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#translationXBy(float))`(float value) ` This method will cause the View's`translationX`property to be animated by the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[translationY](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#translationY(float))`(float value) ` This method will cause the View's`translationY`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[translationYBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#translationYBy(float))`(float value) ` This method will cause the View's`translationY`property to be animated by the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[translationZ](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#translationZ(float))`(float value) ` This method will cause the View's`translationZ`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[translationZBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#translationZBy(float))`(float value) ` This method will cause the View's`translationZ`property to be animated by the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[withEndAction](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#withEndAction(java.lang.Runnable))`(Runnable runnable) ` Specifies an action to take place when the next animation ends. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[withLayer](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#withLayer())`() ` The View associated with this ViewPropertyAnimator will have its[layer type](https://developer.android.com/reference/android/view/View.html#setLayerType(int, android.graphics.Paint))set to[LAYER_TYPE_HARDWARE](https://developer.android.com/reference/android/view/View.html#LAYER_TYPE_HARDWARE)for the duration of the next animation. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[withStartAction](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#withStartAction(java.lang.Runnable))`(Runnable runnable) ` Specifies an action to take place when the next animation runs. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[x](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#x(float))`(float value) ` This method will cause the View's`x`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[xBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#xBy(float))`(float value) ` This method will cause the View's`x`property to be animated by the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[y](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#y(float))`(float value) ` This method will cause the View's`y`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[yBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#yBy(float))`(float value) ` This method will cause the View's`y`property to be animated by the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[z](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#z(float))`(float value) ` This method will cause the View's`z`property to be animated to the specified value. |
| ` `[ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | ` `[zBy](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#zBy(float))`(float value) ` This method will cause the View's`z`property to be animated by the specified value. |
| ### Inherited methods |
|-----------------------|---|
| [](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#)From class` java.lang.Object ` |-------------------|-------------------------------| | ` Object` | ` clone() ` | | ` boolean` | ` equals(Object arg0) ` | | ` void` | ` finalize() ` | | ` final Class` | ` getClass() ` | | ` int` | ` hashCode() ` | | ` final void` | ` notify() ` | | ` final void` | ` notifyAll() ` | | ` String` | ` toString() ` | | ` final void` | ` wait(long arg0, int arg1) ` | | ` final void` | ` wait(long arg0) ` | | ` final void` | ` wait() ` | ||
## Public methods
### alpha
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|----------------------------------------------|
| `value` | `float`: The value to be animated to.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### alphaBy
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### cancel
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
void cancel ()
```
Cancels all property animations that are currently running or pending.
### getDuration
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
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.
| Returns ||
|--------|-----------------------------------------------------|
| `long` | The duration of animations, in milliseconds.
|
**See also:**
- [setDuration(long)](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#setDuration(long))
### getInterpolator
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
Interpolator getInterpolator ()
```
Returns the timing interpolator that this animation uses.
| Returns ||
|--------------------------------------------------------------------------------------------------|----------------------------------------------------|
| [Interpolator](https://developer.android.com/reference/android/view/animation/Interpolator.html) | The timing interpolator for this animation.
|
### getStartDelay
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
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.
| Returns ||
|--------|-------------------------------------------------------|
| `long` | The startDelay of animations, in milliseconds.
|
**See also:**
- [setStartDelay(long)](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#setStartDelay(long))
### rotation
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|----------------------------------------------|
| `value` | `float`: The value to be animated to.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### rotationBy
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### rotationX
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|----------------------------------------------|
| `value` | `float`: The value to be animated to.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### rotationXBy
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### rotationY
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|----------------------------------------------|
| `value` | `float`: The value to be animated to.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### rotationYBy
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### scaleX
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|----------------------------------------------|
| `value` | `float`: The value to be animated to.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### scaleXBy
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### scaleY
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|----------------------------------------------|
| `value` | `float`: The value to be animated to.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### scaleYBy
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### setDuration
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat setDuration (long value)
```
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.
| Parameters ||
|---------|----------------------------------------------------------------------------------------------------------|
| `value` | `long`: The length of ensuing property animations, in milliseconds. The value cannot be negative.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### setInterpolator
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat setInterpolator (Interpolator value)
```
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.
| Parameters ||
|---------|-----------------------------------------------------------------------------------------|
| `value` | `Interpolator`: The TimeInterpolator to be used for ensuing property animations.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### setListener
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat setListener (ViewPropertyAnimatorListener listener)
```
Sets a listener for events in the underlying Animators that run the property animations.
| Parameters ||
|------------|-----------------------------------------------------------------------------------------------------------------------------------------------|
| `listener` | `ViewPropertyAnimatorListener`: The listener to be called with AnimatorListener events. A value of`null`removes any existing listener.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### setStartDelay
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat setStartDelay (long value)
```
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.
| Parameters ||
|---------|---------------------------------------------------------------------------------------------------------|
| `value` | `long`: The delay of ensuing property animations, in milliseconds. The value cannot be negative.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### setUpdateListener
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat setUpdateListener (ViewPropertyAnimatorUpdateListener listener)
```
Sets a listener for update events in the underlying Animator that runs the property animations.
Prior to API 19, this method will do nothing.
| Parameters ||
|------------|-------------------------------------------------------------------------------------------------------------------------------------------|
| `listener` | `ViewPropertyAnimatorUpdateListener`: The listener to be called with update events. A value of`null`removes any existing listener.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### start
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
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
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|----------------------------------------------|
| `value` | `float`: The value to be animated to.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### translationXBy
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### translationY
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|----------------------------------------------|
| `value` | `float`: The value to be animated to.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### translationYBy
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### translationZ
added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
Prior to API 21, this method will do nothing.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### translationZBy
added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
Prior to API 21, this method will do nothing.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### withEndAction
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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(Runnable)](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#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);
```
For API 14 and 15, this method will run by setting a listener on the ViewPropertyAnimatorCompat object and running the action in that listener's[onAnimationEnd(View)](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorListener#onAnimationEnd(android.view.View))method.
| Parameters ||
|------------|--------------------------------------------------------------------|
| `runnable` | `Runnable`: The action to run when the next animation ends.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### withLayer
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat withLayer ()
```
The View associated with this ViewPropertyAnimator will have its[layer type](https://developer.android.com/reference/android/view/View.html#setLayerType(int, android.graphics.Paint))set to[LAYER_TYPE_HARDWARE](https://developer.android.com/reference/android/view/View.html#LAYER_TYPE_HARDWARE)for the duration of the next animation. As stated in the documentation for[LAYER_TYPE_HARDWARE](https://developer.android.com/reference/android/view/View.html#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[LAYER_TYPE_SOFTWARE](https://developer.android.com/reference/android/view/View.html#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[setLayerType(int, android.graphics.Paint)](https://developer.android.com/reference/android/view/View.html#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.
For API 14 and 15, this method will run by setting a listener on the ViewPropertyAnimatorCompat object, setting a hardware layer in the listener's[onAnimationStart(View)](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorListener#onAnimationStart(android.view.View))method, and then restoring the orignal layer type in the listener's[onAnimationEnd(View)](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorListener#onAnimationEnd(android.view.View))method.
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
**See also:**
- [setLayerType(int, android.graphics.Paint)](https://developer.android.com/https://developer.android.com/reference/android/view/View#setLayerType(int, android.graphics.Paint))
### withStartAction
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat withStartAction (Runnable runnable)
```
Specifies an action to take place when the next animation runs. If there is a[startDelay](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#setStartDelay(long))set on this ViewPropertyAnimator, then the action will run after that startDelay expires, when the actual animation begins. This method, along with[withEndAction(Runnable)](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat#withEndAction(java.lang.Runnable)), is intended to help facilitate choreographing ViewPropertyAnimator animations with other animations or actions in the application.
For API 14 and 15, this method will run by setting a listener on the ViewPropertyAnimatorCompat object and running the action in that listener's[onAnimationStart(View)](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorListener#onAnimationStart(android.view.View))method.
| Parameters ||
|------------|----------------------------------------------------------------------|
| `runnable` | `Runnable`: The action to run when the next animation starts.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### x
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|----------------------------------------------|
| `value` | `float`: The value to be animated to.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### xBy
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### y
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|----------------------------------------------|
| `value` | `float`: The value to be animated to.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### yBy
added in[version 22.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### z
added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
Prior to API 21, this method will do nothing.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
### zBy
added in[version 24.1.0](https://developer.android.com/topic/libraries/support-library/revisions)
```
ViewPropertyAnimatorCompat 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.
Prior to API 21, this method will do nothing.
| Parameters ||
|---------|------------------------------------------------------------------------------------|
| `value` | `float`: The amount to be animated by, as an offset from the current value.
|
| Returns ||
|--------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat) | This object, allowing calls to methods in this class to be chained.
|
-
## Annotations
- [ViewPager.DecorView](https://developer.android.com/reference/android/support/v4/view/ViewPager.DecorView)
-
## Interfaces
- [ActionProvider.VisibilityListener](https://developer.android.com/reference/android/support/v4/view/ActionProvider.VisibilityListener)
- [AsyncLayoutInflater.OnInflateFinishedListener](https://developer.android.com/reference/android/support/v4/view/AsyncLayoutInflater.OnInflateFinishedListener)
- [LayoutInflaterFactory](https://developer.android.com/reference/android/support/v4/view/LayoutInflaterFactory)
- [MenuItemCompat.OnActionExpandListener](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat.OnActionExpandListener)
- [NestedScrollingChild](https://developer.android.com/reference/android/support/v4/view/NestedScrollingChild)
- [NestedScrollingChild2](https://developer.android.com/reference/android/support/v4/view/NestedScrollingChild2)
- [NestedScrollingParent](https://developer.android.com/reference/android/support/v4/view/NestedScrollingParent)
- [NestedScrollingParent2](https://developer.android.com/reference/android/support/v4/view/NestedScrollingParent2)
- [OnApplyWindowInsetsListener](https://developer.android.com/reference/android/support/v4/view/OnApplyWindowInsetsListener)
- [ScrollingView](https://developer.android.com/reference/android/support/v4/view/ScrollingView)
- [TintableBackgroundView](https://developer.android.com/reference/android/support/v4/view/TintableBackgroundView)
- [ViewPager.OnAdapterChangeListener](https://developer.android.com/reference/android/support/v4/view/ViewPager.OnAdapterChangeListener)
- [ViewPager.OnPageChangeListener](https://developer.android.com/reference/android/support/v4/view/ViewPager.OnPageChangeListener)
- [ViewPager.PageTransformer](https://developer.android.com/reference/android/support/v4/view/ViewPager.PageTransformer)
- [ViewPropertyAnimatorListener](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorListener)
- [ViewPropertyAnimatorUpdateListener](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorUpdateListener)
-
## Classes
- [AbsSavedState](https://developer.android.com/reference/android/support/v4/view/AbsSavedState)
- [AccessibilityDelegateCompat](https://developer.android.com/reference/android/support/v4/view/AccessibilityDelegateCompat)
- [ActionProvider](https://developer.android.com/reference/android/support/v4/view/ActionProvider)
- [AsyncLayoutInflater](https://developer.android.com/reference/android/support/v4/view/AsyncLayoutInflater)
- [GestureDetectorCompat](https://developer.android.com/reference/android/support/v4/view/GestureDetectorCompat)
- [GravityCompat](https://developer.android.com/reference/android/support/v4/view/GravityCompat)
- [InputDeviceCompat](https://developer.android.com/reference/android/support/v4/view/InputDeviceCompat)
- [LayoutInflaterCompat](https://developer.android.com/reference/android/support/v4/view/LayoutInflaterCompat)
- [MarginLayoutParamsCompat](https://developer.android.com/reference/android/support/v4/view/MarginLayoutParamsCompat)
- [MenuCompat](https://developer.android.com/reference/android/support/v4/view/MenuCompat)
- [MenuItemCompat](https://developer.android.com/reference/android/support/v4/view/MenuItemCompat)
- [MotionEventCompat](https://developer.android.com/reference/android/support/v4/view/MotionEventCompat)
- [NestedScrollingChildHelper](https://developer.android.com/reference/android/support/v4/view/NestedScrollingChildHelper)
- [NestedScrollingParentHelper](https://developer.android.com/reference/android/support/v4/view/NestedScrollingParentHelper)
- [PagerAdapter](https://developer.android.com/reference/android/support/v4/view/PagerAdapter)
- [PagerTabStrip](https://developer.android.com/reference/android/support/v4/view/PagerTabStrip)
- [PagerTitleStrip](https://developer.android.com/reference/android/support/v4/view/PagerTitleStrip)
- [PointerIconCompat](https://developer.android.com/reference/android/support/v4/view/PointerIconCompat)
- [ScaleGestureDetectorCompat](https://developer.android.com/reference/android/support/v4/view/ScaleGestureDetectorCompat)
- [VelocityTrackerCompat](https://developer.android.com/reference/android/support/v4/view/VelocityTrackerCompat)
- [ViewCompat](https://developer.android.com/reference/android/support/v4/view/ViewCompat)
- [ViewConfigurationCompat](https://developer.android.com/reference/android/support/v4/view/ViewConfigurationCompat)
- [ViewGroupCompat](https://developer.android.com/reference/android/support/v4/view/ViewGroupCompat)
- [ViewPager](https://developer.android.com/reference/android/support/v4/view/ViewPager)
- [ViewPager.LayoutParams](https://developer.android.com/reference/android/support/v4/view/ViewPager.LayoutParams)
- [ViewPager.SavedState](https://developer.android.com/reference/android/support/v4/view/ViewPager.SavedState)
- [ViewPager.SimpleOnPageChangeListener](https://developer.android.com/reference/android/support/v4/view/ViewPager.SimpleOnPageChangeListener)
- [ViewParentCompat](https://developer.android.com/reference/android/support/v4/view/ViewParentCompat)
- [ViewPropertyAnimatorCompat](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorCompat)
- [ViewPropertyAnimatorListenerAdapter](https://developer.android.com/reference/android/support/v4/view/ViewPropertyAnimatorListenerAdapter)
- [WindowCompat](https://developer.android.com/reference/android/support/v4/view/WindowCompat)
- [WindowInsetsCompat](https://developer.android.com/reference/android/support/v4/view/WindowInsetsCompat)