ViewPropertyAnimator (xey-elib)

java.lang.Object
- xey.elib.nineold.view.ViewPropertyAnimator

```
public abstract class ViewPropertyAnimator
extends Object
```
This class enables automatic and optimized animation of select properties on View objects. If only one or two properties on a View object are being animated, then using an ObjectAnimator is fine; the property setters called by ObjectAnimator are well equipped to do the right thing to set the property and invalidate the view appropriately. But if several properties are animated simultaneously, or if you just want a more convenient syntax to animate a specific property, then ViewPropertyAnimator might be more well-suited to the task.
This class may provide better performance for several simultaneous animations, because it will optimize invalidate calls to take place only once for several properties instead of each animated property independently causing its own invalidation. Also, the syntax of using this class could be easier to use because the caller need only tell the View object which property to animate, and the value to animate either to or by, and this class handles the details of configuring the underlying Animator class and starting it.

This class is not constructed by the caller, but rather by the View whose properties it will animate. Calls to View.animate() will return a reference to the appropriate ViewPropertyAnimator object for that View.

构造器概要

构造器
构造器和说明

ViewPropertyAnimator()

构造器
构造器和说明
`ViewPropertyAnimator()`

方法概要

方法
限定符和类型	方法和说明
`abstract ViewPropertyAnimator`	`alpha(float value)` This method will cause the View's `alpha` property to be animated to the specified value.
`abstract ViewPropertyAnimator`	`alphaBy(float value)` This method will cause the View's `alpha` property to be animated by the specified value.
`static ViewPropertyAnimator`	`animate(android.view.View view)` This method returns a ViewPropertyAnimator object, which can be used to animate specific properties on this View.
`abstract void`	`cancel()` Cancels all property animations that are currently running or pending.
`abstract long`	`getDuration()` Returns the current duration of property animations.
`abstract long`	`getStartDelay()` Returns the current startDelay of property animations.
`abstract ViewPropertyAnimator`	`rotation(float value)` This method will cause the View's `rotation` property to be animated to the specified value.
`abstract ViewPropertyAnimator`	`rotationBy(float value)` This method will cause the View's `rotation` property to be animated by the specified value.
`abstract ViewPropertyAnimator`	`rotationX(float value)` This method will cause the View's `rotationX` property to be animated to the specified value.
`abstract ViewPropertyAnimator`	`rotationXBy(float value)` This method will cause the View's `rotationX` property to be animated by the specified value.
`abstract ViewPropertyAnimator`	`rotationY(float value)` This method will cause the View's `rotationY` property to be animated to the specified value.
`abstract ViewPropertyAnimator`	`rotationYBy(float value)` This method will cause the View's `rotationY` property to be animated by the specified value.
`abstract ViewPropertyAnimator`	`scaleX(float value)` This method will cause the View's `scaleX` property to be animated to the specified value.
`abstract ViewPropertyAnimator`	`scaleXBy(float value)` This method will cause the View's `scaleX` property to be animated by the specified value.
`abstract ViewPropertyAnimator`	`scaleY(float value)` This method will cause the View's `scaleY` property to be animated to the specified value.
`abstract ViewPropertyAnimator`	`scaleYBy(float value)` This method will cause the View's `scaleY` property to be animated by the specified value.
`abstract ViewPropertyAnimator`	`setDuration(long duration)` Sets the duration for the underlying animator that animates the requested properties.
`abstract ViewPropertyAnimator`	`setInterpolator(android.view.animation.Interpolator interpolator)` Sets the interpolator for the underlying animator that animates the requested properties.
`abstract ViewPropertyAnimator`	`setListener(Animator.AnimatorListener listener)` Sets a listener for events in the underlying Animators that run the property animations.
`abstract ViewPropertyAnimator`	`setStartDelay(long startDelay)` Sets the startDelay for the underlying animator that animates the requested properties.
`abstract void`	`start()` Starts the currently pending property animations immediately.
`abstract ViewPropertyAnimator`	`translationX(float value)` This method will cause the View's `translationX` property to be animated to the specified value.
`abstract ViewPropertyAnimator`	`translationXBy(float value)` This method will cause the View's `translationX` property to be animated by the specified value.
`abstract ViewPropertyAnimator`	`translationY(float value)` This method will cause the View's `translationY` property to be animated to the specified value.
`abstract ViewPropertyAnimator`	`translationYBy(float value)` This method will cause the View's `translationY` property to be animated by the specified value.
`abstract ViewPropertyAnimator`	`x(float value)` This method will cause the View's `x` property to be animated to the specified value.
`abstract ViewPropertyAnimator`	`xBy(float value)` This method will cause the View's `x` property to be animated by the specified value.
`abstract ViewPropertyAnimator`	`y(float value)` This method will cause the View's `y` property to be animated to the specified value.
`abstract ViewPropertyAnimator`	`yBy(float value)` This method will cause the View's `y` property to be animated by the specified value.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - ViewPropertyAnimator
```
public ViewPropertyAnimator()
```
- 方法详细资料
  - animate
```
public static ViewPropertyAnimator animate(android.view.View view)
```
    This method returns a ViewPropertyAnimator object, which can be used to animate specific properties on this View.
    
    参数:
    view - View to animate.
    
    返回:
    The ViewPropertyAnimator associated with this View.
  - setDuration
```
public abstract 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.
    
    参数:
    duration - The length of ensuing property animations, in milliseconds. The value cannot be negative.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
  - getDuration
```
public abstract 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.
    
    返回:
    The duration of animations, in milliseconds.
    另请参阅:
    setDuration(long)
  - getStartDelay
```
public abstract 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.
    
    返回:
    The startDelay of animations, in milliseconds.
    另请参阅:
    setStartDelay(long)
  - setStartDelay
```
public abstract 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.
    
    参数:
    startDelay - The delay of ensuing property animations, in milliseconds. The value cannot be negative.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
  - setInterpolator
```
public abstract ViewPropertyAnimator setInterpolator(android.view.animation.Interpolator 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.
    
    参数:
    interpolator - The TimeInterpolator to be used for ensuing property animations.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
  - setListener
```
public abstract ViewPropertyAnimator setListener(Animator.AnimatorListener listener)
```
    Sets a listener for events in the underlying Animators that run the property animations.
    
    参数:
    listener - The listener to be called with AnimatorListener events.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
  - start
```
public abstract 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.
  - cancel
```
public abstract void cancel()
```
    Cancels all property animations that are currently running or pending.
  - x
```
public abstract 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.
    
    参数:
    value - The value to be animated to.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setX(float)
  - xBy
```
public abstract 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.
    
    参数:
    value - The amount to be animated by, as an offset from the current value.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setX(float)
  - y
```
public abstract 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.
    
    参数:
    value - The value to be animated to.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setY(float)
  - yBy
```
public abstract 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.
    
    参数:
    value - The amount to be animated by, as an offset from the current value.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setY(float)
  - rotation
```
public abstract 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.
    
    参数:
    value - The value to be animated to.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setRotation(float)
  - rotationBy
```
public abstract 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.
    
    参数:
    value - The amount to be animated by, as an offset from the current value.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setRotation(float)
  - rotationX
```
public abstract 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.
    
    参数:
    value - The value to be animated to.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setRotationX(float)
  - rotationXBy
```
public abstract 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.
    
    参数:
    value - The amount to be animated by, as an offset from the current value.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setRotationX(float)
  - rotationY
```
public abstract 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.
    
    参数:
    value - The value to be animated to.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setRotationY(float)
  - rotationYBy
```
public abstract 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.
    
    参数:
    value - The amount to be animated by, as an offset from the current value.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setRotationY(float)
  - translationX
```
public abstract 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.
    
    参数:
    value - The value to be animated to.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setTranslationX(float)
  - translationXBy
```
public abstract 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.
    
    参数:
    value - The amount to be animated by, as an offset from the current value.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setTranslationX(float)
  - translationY
```
public abstract 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.
    
    参数:
    value - The value to be animated to.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setTranslationY(float)
  - translationYBy
```
public abstract 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.
    
    参数:
    value - The amount to be animated by, as an offset from the current value.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setTranslationY(float)
  - scaleX
```
public abstract 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.
    
    参数:
    value - The value to be animated to.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setScaleX(float)
  - scaleXBy
```
public abstract 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.
    
    参数:
    value - The amount to be animated by, as an offset from the current value.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setScaleX(float)
  - scaleY
```
public abstract 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.
    
    参数:
    value - The value to be animated to.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setScaleY(float)
  - scaleYBy
```
public abstract 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.
    
    参数:
    value - The amount to be animated by, as an offset from the current value.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setScaleY(float)
  - alpha
```
public abstract 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.
    
    参数:
    value - The value to be animated to.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setAlpha(float)
  - alphaBy
```
public abstract 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.
    
    参数:
    value - The amount to be animated by, as an offset from the current value.
    
    返回:
    This object, allowing calls to methods in this class to be chained.
    另请参阅:
    View.setAlpha(float)

类 ViewPropertyAnimator

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

ViewPropertyAnimator

方法详细资料

animate

setDuration

getDuration

getStartDelay

setStartDelay

setInterpolator

setListener

start

cancel

x

xBy

y

yBy

rotation

rotationBy

rotationX

rotationXBy

rotationY

rotationYBy

translationX

translationXBy

translationY

translationYBy

scaleX

scaleXBy

scaleY

scaleYBy

alpha

alphaBy