安卓29开发文档翻译：ViewPropertyAnimator

利用 这个类，可以针对视图（View）对象的指定属性，制造出自动化、高效率的动画效果。如果 你只需要针对某个视图（View）对象的一两个属性产生动画效果，那么，直接使用 ObjectAnimator 就足够了；ObjectAnimator 会调用那些属性设置器函数， 以正确地设置对应的属性，并将视图对象标记为需要重新绘制的状态。 如果你是需要同时针对多个属性制造动画效果，或 只 是想用更简洁的语法来针对特定的属性制造动画效果 ，那么，使用ViewPropertyAnimator 就更合适一些。

这个类，能够提升多个属性上发生的并行动画的性能。因为，它会仅使用一次调用来将多个属性标记为失效，而不是针对每个动画属性单独标记一次。另外，使用这个类的时候，所需要的语法也更简单一些。调用者只需要向对象指定，要针对什么属性来制造动画、属性的值的变化目标或是变化量。这个类就会处理其中的细节，它会对底层的动画器（Animator）类进行配置，并且启动它。

这个类，并不是由调用者来构造的，而是由 要进行动画的视图 （View） 对象来构造的。调用 View.animate() ，即会返回该视图（View）的相应视图属性动画器（ViewPropertyAnimator）对象的引用。

公有方法

alpha

自此版本开始加入 ： 应用编程级别12

public ViewPropertyAnimator alpha (float value)

这个方法，会导致该视图（View）的不透明度（ alpha ）属性以动画形式变化到指定的值。 这个属性上已经在运行的动画，会被取消。

参考：

• •. View.setAlpha(float)

cancel

自此版本开始引入： 应用编程接口级别14

public void cancel ()

取消掉所有目前处于运行或排队状态的属性动画。

getDuration

自此版本开始引入： 应用编程接口级别14

public long getDuration ()

返回那些属性动画的当前持续时间。如果之前向本个对象设置了持续时间，则会返回那个持续时间值。否则，会返回底层的动画器（Animator）的默认值。

参考：

• •. setDuration(long)

getInterpolator

自此版本开始引入： 应用编程接口级别18

public TimeInterpolator getInterpolator ()

返回这个动画所使用的时间插值器。

getStartDelay

自此版本开始引入： 应用编程接口级别14

public long getStartDelay ()

返回属性动画的当前开始延迟（startDelay）。如果为这个对象设置了开始延迟，则会返回设置的那个值。否则，会返回底层动画器（Animator）的默认值。

参考：

• •. setStartDelay(long)

rotation

自此版本开始引入： 应用编程接口级别12

public ViewPropertyAnimator rotation (float value)

这个方法，会导致该视图（View）的旋转角度（ rotation ）属性以动画形式改变到指定的值。 该属性上已经处于运行状态的动画会被取消。

参考：

• •. View.setRotation(float)

rotationX

自此版本开始引入： 应用编程接口级别12

public ViewPropertyAnimator rotationX (float value)

这个方法，会导致该视图（View）的X轴旋转（ rotationX ）属性以动画形式变化到指定的目标值。 该属性上已经运行的动画会被取消。

参考：

• •. View.setRotationX(float)

rotationY

自此版本开始引入： 应用编程接口级别12

public ViewPropertyAnimator rotationY (float value)

这个方法，会导致 该视图（View）的Y轴旋转（ rotationY ）属性以动画形式变化到指定的目标值。该属性上已经运行的动画会取消。

参考：

• •. View.setRotationY(float)

scaleX

自此版本开始引入： 应用编程接口级别12

public ViewPropertyAnimator scaleX (float value)

这个方法，会导致该视图（View）的X轴缩放（ scaleX ）属性以动画形式变化到指定的目标值。 该属性上已经运行的动画会被取消。

参考：

• •. View.setScaleX(float)

scaleY

自此版本开始引入： 应用编程接口级别12

public ViewPropertyAnimator scaleY (float value)

这个方法，会导致该视图（View）的Y轴缩放（ scaleY ）属性以动画形式变化到指定的目标值。 该属性上已经运行的动画会被取消。

参考：

• •. View.setScaleY(float)

start

自此版本开始引入： 应用编程接口级别14

public void start ()

立即启动当前排队 中的属性动画。 对 start() 的调用是可选的，因为 ，所有的动画都会在下一轮事件周期中自动启动。然而 ，如果那些动画需要立即同步启动（ 而不是等到视图体系处理下个事件的时刻，那就是动画会自动启动的时刻 ），那么 ，就可以调用这个方法。

translationX

自此版本开始引入： 应用编程接口级别12

public ViewPropertyAnimator translationX (float value)

这个方法，会导致该视图（View）的X轴偏移（ translationX ）属性以动画形式变化到指定的目标值。 该属性上已经运行的动画会被取消。

参考：

• •. View.setTranslationX(float)

translationY

自此版本开始引入： 应用编程接口级别12

public ViewPropertyAnimator translationY (float value)

这个方法，会导致该视图（View）的Y轴偏移（ translationY ）属性以动画形式变化到指定的目标值。 该属性上已经运行的动画会被取消。

参考：

• •. View.setTranslationY(float)

translationZ

自此版本开始引入： 应用编程接口级别21

public ViewPropertyAnimator translationZ (float value)

这个方法，会导致该视图（View）的Z轴偏移（ translationZ ）属性以动画形式变化到指定的目标值。 该属性上 已经运行 的动画会被取消。

参考：

• •. View.setTranslationZ(float)

withEndAction

自此版本开始引入： 应用编程接口级别16

public ViewPropertyAnimator withEndAction ( Runnable runnable)

指定 一个动作，当下一个动画结束时，该动作会被执行。只有 当动画正常结束时，该动作才会被执行；如果 该个视图属性动画器（ViewPropertyAnimator）对象在动画过程中被取消掉了，那么，该动作就不会执行。 这个方法，以及 withStartAction(java.lang.Runnable) 方法 ，其设计意图是，用于将视图属性动画器（ViewPropertyAnimator）动画与其它动画以及应用程序中的其它动作编排起来。

例如，以下代码，会将某个视图以动画形式移动到x=200，再又以动画形式移动回到0：

Runnable endAction = new Runnable() {

public void run() {

view.animate().x(0);

}

};

view.animate().x(200).withEndAction(endAction);

withStartAction

自此版本开始引入： 应用编程接口级别16

public ViewPropertyAnimator withStartAction ( Runnable runnable)

指定 要在下个动画开始时执行的动作。如果 在这个视图属性动画器（ViewPropertyAnimator）上设置了开始延迟（ startDelay ），那么， 在开始延迟时间结束、实际动画开始时，该动作会被执行。 这个方法， 以及 withEndAction(java.lang.Runnable) 方法 ，其 设计意图是，用于将视图属性动画器（ViewPropertyAnimator）动画与其它动画以及应用程序中的其它动作编排起来。

x

自此版本开始引入： 应用编程接口级别12

public ViewPropertyAnimator x (float value)

这个方法，会导致视图（View ）的 x 属性以动画形式变化到指定的目标值。 该属性上已经运行的动画会被取消。

参考：

• •. View.setX(float)

y

自此版本开始引入： 应用编程接口级别12

public ViewPropertyAnimator y (float value)

这个方法，会导致视图（View）的 y 属性以动画形式变化到指定的目标值。 该属性上已经运行的动画会被取消。

参考：

• •. View.setY(float)

z

自此版本开始引入： 应用编程接口级别21

public ViewPropertyAnimator z (float value)

这个方法，会导致视图（View）的 z 属性以动画形式变化到指定的目标值。 该属性上已经运行的动画会被取消。

参考：

• •. View.setZ(float)

雷鸟主题 鸟