StupidBeauty
Read times:235Posted at:Sun May 23 10:42:25 2021 - no title specified

安卓29开发文档翻译:ViewPropertyAnimator

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

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

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

公有方法

alpha

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

public ViewPropertyAnimator alpha (float value)

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

参数

value

float: 要以动画形式变化到的目标值。值的范围是0.0f1.0f,包括这两个值在内。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

cancel

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

public void cancel ()

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

getDuration

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

public long getDuration ()

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

返回

long

动画的持续时间,单位是毫秒。

参考

getInterpolator

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

public TimeInterpolator getInterpolator ()

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

返回

TimeInterpolator

这个动画的时间插值器。

getStartDelay

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

public long getStartDelay ()

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

返回

long

动画的开始延迟,单位是毫秒。

参考

rotation

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

public ViewPropertyAnimator rotation (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

rotationX

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

public ViewPropertyAnimator rotationX (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链接调用。

参考

rotationY

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

public ViewPropertyAnimator rotationY (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

scaleX

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

public ViewPropertyAnimator scaleX (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

scaleY

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

public ViewPropertyAnimator scaleY (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

start

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

public void start ()

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

translationX

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

public ViewPropertyAnimator translationX (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

translationY

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

public ViewPropertyAnimator translationY (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

translationZ

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

public ViewPropertyAnimator translationZ (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

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);

 

参数

runnable

Runnable: 当下个动画结束时,要执行的动作。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

withStartAction

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

public ViewPropertyAnimator withStartAction (Runnable runnable)

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

参数

runnable

Runnable: 在下一个动画开始时,要执行的动作。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

x

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

public ViewPropertyAnimator x (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

y

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

public ViewPropertyAnimator y (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

z

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

public ViewPropertyAnimator z (float value)

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

参数

value

float: 动画的目标值。

返回

ViewPropertyAnimator

这个对象本身,用于链式调用。

参考

 

雷鸟主题 鸟

Your opinions
Your name:Email:Website url:Opinion content:
- no title specified

HxLauncher: Launch Android applications by voice commands