StupidBeauty
Read times:1128Posted 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