- 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)КонструкторKeyFrameKeyFrame(Duration time, String name, EventHandler<ActionEvent> onFinished, Collection<KeyValue> values)КонструкторKeyFrameKeyFrame(Duration time, String name, EventHandler<ActionEvent> onFinished, KeyValue... values)КонструкторKeyFrameKeyFrame(Duration time, KeyValue... values)КонструкторKeyFrameKeyFrame(Duration time, EventHandler<ActionEvent> onFinished, KeyValue... values)КонструкторKeyFrame
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание booleanequals(Object obj)Указывает, является ли другой объект "равным" этому.StringgetName()ВозвращаетnameэтогоKeyFrame.EventHandler<ActionEvent>getOnFinished()Возвращает обработчик событийonFinishedэтогоKeyFrame.DurationgetTime()Возвращает смещение времени этогоKeyFrame.Set<KeyValue>getValues()Возвращает неизменяемыйSetэкземпляровKeyValue.inthashCode()Возвращает хэш-код для этого объектаKeyFrame.StringtoString()Возвращает строковое представление этого объектаKeyFrame.
-
Подробное описание конструкторов
-
KeyFrame
public KeyFrame(Duration time, String name, EventHandler<ActionEvent> onFinished, Collection<KeyValue> values)
КонструкторKeyFrameЕсли переданный
KeyValueявляетсяnullили дубликатом, он будет проигнорирован.- Параметры:
-
time- thetime -
name- thename -
onFinished- theonFinished -
values- aObservableListofKeyValueinstances - Исключения:
-
NullPointerException- еслиtimeравно null -
IllegalArgumentException- еслиtimeнекорректен (см.time)
-
KeyFrame
public KeyFrame(Duration time, String name, EventHandler<ActionEvent> onFinished, KeyValue... values)
КонструкторKeyFrameЕсли переданный
KeyValueявляетсяnullили дубликатом, он будет проигнорирован.- Параметры:
-
time- thetime -
name- thename -
onFinished- theonFinished -
values- theKeyValueinstances - Исключения:
-
NullPointerException- еслиtimeравно null -
IllegalArgumentException- еслиtimeнекорректен (см.time)
-
KeyFrame
public KeyFrame(Duration time, EventHandler<ActionEvent> onFinished, KeyValue... values)
КонструкторKeyFrame- Параметры:
-
time- thetime -
onFinished- theonFinished -
values- theKeyValueinstances - Исключения:
-
NullPointerException- еслиtimeравно null -
IllegalArgumentException- еслиtimeнекорректен (см.time)
-
KeyFrame
public KeyFrame(Duration time, String name, KeyValue... values)
КонструкторKeyFrame- Параметры:
-
time- thetime -
name- thename -
values- theKeyValueinstances - Исключения:
-
NullPointerException- еслиtimeравно null -
IllegalArgumentException- еслиtimeнекорректен (см.time)
-
KeyFrame
public KeyFrame(Duration time, KeyValue... values)
КонструкторKeyFrame- Параметры:
-
time- thetime -
values- theKeyValueinstances - Исключения:
-
NullPointerException- еслиtimeравно null -
IllegalArgumentException- еслиtimeнекорректен (см.time)
-
-
Подробное описание методов
-
getTime
public Duration getTime()
Возвращает смещение времени этогоKeyFrame. ВозвращаемаяDurationопределяет смещение времени в пределах одного циклаTimeline, в котором будут установленыKeyValuesи в котором будет вызвана функцияonFinished.Смещение времени
KeyFrameдолжно быть больше или равноDuration.ZEROи не может бытьDuration.UNKNOWN. Примечание: хотя единицей измеренияtimeявляется миллисекунда, точность зависит от операционной системы и обычно будет больше. Например, анимации на настольных системах обычно выполняются с максимальной частотой 60 кадров в секунду, что дает точность ~17 мс.- Возвращает:
- смещение времени
-
getValues
public Set<KeyValue> getValues()
Возвращает неизменяемыйSetKeyValueэкземпляров.KeyValueопределяет целевой объект и желаемое значение, которое должно быть интерполировано в указанное время этогоKeyFrame.- Возвращает:
- неизменяемый
SetKeyValueэкземпляров
-
getOnFinished
public EventHandler<ActionEvent> getOnFinished()
Возвращает обработчик событияonFinishedэтогоKeyFrame. Обработчик событияonFinished— это функция, которая вызывается, когда прошедшее время в цикле достигает указанного времени этогоKeyFrame. ФункцияonFinishedбудет вызвана, если прошедшее время достигнет указанного значения, даже если оно никогда точно не равнялось этому значению.- Возвращает:
- обработчик события
onFinished
-
getName
public String getName()
ВозвращаетnameэтогоKeyFrame. Если кTimelineдобавлен именованныйKeyFrame, автоматически будет добавлен cuepoint сnameиtimeKeyFrame. ЕслиKeyFrameудален, cuepoint также будет удален.- Возвращает:
name
-
toString
public String toString()
Возвращает строковое представление этого объектаKeyFrame.
-
hashCode
public int hashCode()
Возвращает хэш-код для этого объектаKeyFrame.
-
© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.