Module javafx.graphics

软件包 javafx.animation

Class KeyFrame

java.lang.Object

javafx.animation.KeyFrame

public final class KeyFrame
extends Object

在指定的时间点定义一组沿Timeline内插的变量的目标值 。

开发者通过提供目标值来控制连续关键帧之间的间隔的一组变量的插值和与每个变量相关联的Interpolator 。 这些变量被内插，使得它们将在指定的时间达到其目标值。 一个onFinished函数对每个调用KeyFrame如果提供一个。 A KeyFrame可以选择有一个name ，这将导致一个自动添加到Timeline 。

从以下版本开始：

JavaFX 2.0

另请参见：

Timeline ， KeyValue ， Interpolator

构造方法摘要

构造方法

Constructor	描述
KeyFrame(Duration time, String name, KeyValue... values)	构造函数 KeyFrame
KeyFrame(Duration time, String name, EventHandler<ActionEvent> onFinished, Collection<KeyValue> values)	构造函数 KeyFrame
KeyFrame(Duration time, String name, EventHandler<ActionEvent> onFinished, KeyValue... values)	构造函数 KeyFrame
KeyFrame(Duration time, KeyValue... values)	构造函数 KeyFrame
KeyFrame(Duration time, EventHandler<ActionEvent> onFinished, KeyValue... values)	构造函数 KeyFrame

方法摘要

Modifier and Type	方法	描述
boolean	equals(Object obj)	指示一些其他对象是否等于此。
String	getName()	返回这个 name的 KeyFrame 。
EventHandler<ActionEvent>	getOnFinished()	返回 onFinished此事件处理 KeyFrame 。
Duration	getTime()	返回此 KeyFrame的时间偏移量。
Set<KeyValue>	getValues()	返回一个不可变Set的KeyValue实例。
int	hashCode()	返回此 KeyFrame对象的哈希码。
String	toString()	返回此 KeyFrame对象的字符串表示形式。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

构造方法详细信息

KeyFrame

public KeyFrame(Duration time,
                String name,
                EventHandler<ActionEvent> onFinished,
                Collection<KeyValue> values)

构造函数KeyFrame

如果在KeyValue传递的是null或重复，则将被忽略。

参数

time - time

name - name

onFinished - onFinished

values - 一个ObservableList的KeyValue实例

异常

NullPointerException - 如果 time为空

IllegalArgumentException - 如果 time无效（见 time ）

KeyFrame

public KeyFrame(Duration time,
                String name,
                EventHandler<ActionEvent> onFinished,
                KeyValue... values)

构造函数KeyFrame

如果在KeyValue传递的是null或重复，则将被忽略。

参数

time - time

name - name

onFinished - onFinished

values - KeyValue实例

异常

NullPointerException - 如果 time为空

IllegalArgumentException - 如果 time无效（见 time ）

KeyFrame

public KeyFrame(Duration time,
                EventHandler<ActionEvent> onFinished,
                KeyValue... values)

构造函数 KeyFrame

参数

time - time

onFinished - onFinished

values - KeyValue实例

异常

NullPointerException - 如果 time为空

IllegalArgumentException - 如果 time无效（见 time ）

KeyFrame

public KeyFrame(Duration time,
                String name,
                KeyValue... values)

构造函数 KeyFrame

参数

time - time

name - name

values - KeyValue实例

异常

NullPointerException - 如果 time为空

IllegalArgumentException - 如果 time无效（见 time ）

KeyFrame

public KeyFrame(Duration time,
                KeyValue... values)

构造函数 KeyFrame

参数

time - time

values - KeyValue实例

异常

NullPointerException - 如果 time为空

IllegalArgumentException - 如果 time无效（见 time ）

方法详细信息

getTime

public Duration getTime()

返回此KeyFrame的时间偏移量。 返回Duration定义了一个时间的单个周期内的偏移Timeline在该KeyValues将被设置，并在该onFinished函数的变量将被调用。

所述time一个的KeyFrame必须是大于或等于Duration.ZERO ，它不能是Duration.UNKNOWN 。 注意： time的单位是毫秒，粒度取决于底层的操作系统，一般会更大。 例如，桌面系统上的动画通常运行时间最多为60fps，粒度为〜17 ms。

结果

时间偏移

getValues

public Set<KeyValue> getValues()

返回Set个不可变的Set实例。 A KeyValue定义了一个目标和在该KeyFrame的指定时间内插的KeyFrame 。

结果

一个不可变的Set的KeyValue实例

getOnFinished

public EventHandler<ActionEvent> getOnFinished()

返回onFinished此事件处理KeyFrame 。 onFinished事件处理程序是一个函数，当循环的经过时间通过此KeyFrame的指定时间时KeyFrame 。 如果经过时间经过指定值，则onFinished函数变量将被调用，即使它不会完全等于时间值。

结果

onFinished事件处理程序

getName

public String getName()

返回name这个KeyFrame 。 如果将KeyFrame添加到Timeline中 ，则将自动添加name和time的KeyFrame 。 如果KeyFrame被删除，那么该点也将被删除。

结果

name

toString

public String toString()

返回此 KeyFrame对象的字符串表示形式。

重写：

toString在 Object

结果

字符串表示

hashCode

public int hashCode()

返回此 KeyFrame对象的哈希码。

重写：

hashCode在 Object

结果

哈希码

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

指示一些其他对象是否等于此。 两个KeyFrames被认为是平等的，如果他们的time ， onFinished ，并values相等。

重写：

equals在 Object

参数

obj - 用于比较的参考对象。

结果

true如果这与obj相同，否则为 false

另请参见：

Object.hashCode() ， HashMap