- java.lang.Object
-
- javafx.animation.KeyFrame
-
public final class KeyFrame extends Object
Timelineに沿って補間される一連の変数に対して、特定の時点におけるターゲット値を定義します。開発者は、各変数に関連付けられたターゲット値および
Interpolatorを指定することによって、連続するキー・フレーム間の間隔に対する一連の変数の補間を制御します。 変数は、指定された時間にターゲット値に到達するように補間されます。onFinished関数が指定されている場合は、各KeyFrameで呼び出されます。KeyFrameにはオプションでnameを指定でき、指定した場合、キュー・ポイントがTimelineに自動的に追加されるようになります。- 導入されたバージョン:
- JavaFX 2.0
- 関連項目:
Timeline,KeyValue,Interpolator
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 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のコンストラクタ
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 booleanequals(Object obj)このオブジェクトと他のオブジェクトが等しいかどうかを示します。StringgetName()このKeyFrameのnameを返します。EventHandler<ActionEvent>getOnFinished()このKeyFrameのonFinishedイベント・ハンドラを返します。DurationgetTime()このKeyFrameの時間オフセットを返します。Set<KeyValue>getValues()KeyValueインスタンスの不変のSetを返します。inthashCode()このKeyFrameオブジェクトのハッシュ・コードを返します。StringtoString()このKeyFrameオブジェクトの文字列表現を返します。
-
-
-
コンストラクタの詳細
-
KeyFrame
public KeyFrame(Duration time, String name, EventHandler<ActionEvent> onFinished, Collection<KeyValue> values)
KeyFrameのコンストラクタ渡された
KeyValueがnullか、重複している場合は無視されます。- パラメータ:
time-timename-nameonFinished-onFinishedvalues-KeyValueインスタンスのObservableList- 例外:
NullPointerException-timeがnullの場合IllegalArgumentException-timeが無効な場合(timeを参照)
-
KeyFrame
public KeyFrame(Duration time, String name, EventHandler<ActionEvent> onFinished, KeyValue... values)
KeyFrameのコンストラクタ渡された
KeyValueがnullか、重複している場合は無視されます。- パラメータ:
time-timename-nameonFinished-onFinishedvalues-KeyValueインスタンス- 例外:
NullPointerException-timeがnullの場合IllegalArgumentException-timeが無効な場合(timeを参照)
-
KeyFrame
public KeyFrame(Duration time, EventHandler<ActionEvent> onFinished, KeyValue... values)
KeyFrameのコンストラクタ- パラメータ:
time-timeonFinished-onFinishedvalues-KeyValueインスタンス- 例外:
NullPointerException-timeがnullの場合IllegalArgumentException-timeが無効な場合(timeを参照)
-
KeyFrame
public KeyFrame(Duration time, String name, KeyValue... values)
KeyFrameのコンストラクタ- パラメータ:
time-timename-namevalues-KeyValueインスタンス- 例外:
NullPointerException-timeがnullの場合IllegalArgumentException-timeが無効な場合(timeを参照)
-
KeyFrame
public KeyFrame(Duration time, KeyValue... values)
KeyFrameのコンストラクタ- パラメータ:
time-timevalues-KeyValueインスタンス- 例外:
NullPointerException-timeがnullの場合IllegalArgumentException-timeが無効な場合(timeを参照)
-
-
メソッドの詳細
-
getTime
public Duration getTime()
このKeyFrameの時間オフセットを返します。 返されるDurationは、単一サイクルのTimelineにおいて、KeyValuesの設定およびonFinished関数変数の呼出しが行われる時間オフセットを示します。KeyFrameのtimeは、Duration.ZERO以上にする必要があり、Duration.UNKNOWNには設定できません。 注意:timeの単位はミリ秒ですが、粒度は基礎となるオペレーティング・システムによって異なり、一般的には大きくなります。 たとえば、デスクトップ・システム上のアニメーションは、通常、最大60fpsで実行され、その粒度は最大17ミリ秒になります。- 戻り値:
- 時間オフセット
-
getValues
public Set<KeyValue> getValues()
KeyValueインスタンスの不変のSetを返します。KeyValueでは、このKeyFrameの指定時間に補間されるようにする必要がある、ターゲットと目的の値を定義します。- 戻り値:
KeyValueインスタンスの不変のSet
-
getOnFinished
public EventHandler<ActionEvent> getOnFinished()
このKeyFrameのonFinishedイベント・ハンドラを返します。onFinishedイベント・ハンドラは、サイクルの経過時間がこのKeyFrameの指定時間を超えたときに呼び出される関数です。onFinished関数変数は、時間値に正確に一致することがなくても、経過時間が指定値を超えたときに呼び出されます。- 戻り値:
onFinishedイベント・ハンドラ
-
getName
public String getName()
このKeyFrameのnameを返します。 指定したKeyFrameがTimelineに追加されると、そのKeyFrameのnameおよびtimeを持つキュー・ポイントが自動的に追加されます。KeyFrameが削除されると、キュー・ポイントも削除されます。- 戻り値:
name
-
toString
public String toString()
このKeyFrameオブジェクトの文字列表現を返します。
-
hashCode
public int hashCode()
このKeyFrameオブジェクトのハッシュ・コードを返します。- オーバーライド:
hashCode、クラス:Object- 戻り値:
- ハッシュ・コード
- 関連項目:
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
equals
public boolean equals(Object obj)
このオブジェクトと他のオブジェクトが等しいかどうかを示します。time、onFinishedおよびvaluesが等しい場合、2つのKeyFramesは等しいとみなされます。- オーバーライド:
equals、クラス:Object- パラメータ:
obj- 比較対象の参照オブジェクト。- 戻り値:
trueがobjと同じ場合はそれを、それ以外の場合はfalse- 関連項目:
Object.hashCode()、HashMap
-
-