Spec-Zone.ru › OpenJavaFX 21

Класс Timeline

java.lang.Object
javafx.animation.Animation
javafx.animation.Timeline
public final class Timeline extends Animation
Класс Timeline может быть использован для определения произвольной анимации любого WritableValue, например, всех JavaFX Properties.

Анимация, определяемая одним или несколькими KeyFrame, обрабатывает отдельные KeyFrame последовательно, в порядке, заданном KeyFrame.time. Анимируемые свойства, определённые в качестве ключевых значений в KeyFrame.values, интерполируются к/от целевых ключевых значений в указанное время. Начальное положение Timeline зависит от направления Timeline.

Timeline обрабатывает отдельные KeyFrame через заданный интервал времени, но не гарантирует точное время обработки KeyFrame.

Если для time==0s момента времени не указано KeyFrame, оно будет синтезировано с использованием текущих целевых значений на момент вызова Animation.play() или Animation.playFromStart().

Невозможно изменить keyFrames работающей Timeline. Если значение keyFrames изменено для работающей Timeline, её необходимо остановить и запустить заново, чтобы использовать новое значение.

Animation.cycleDurationProperty() будет установлено в наибольшее значение времени среди ключевых кадров Timeline.

Простой Timeline может быть создан так:

 final Timeline timeline = new Timeline();
 timeline.setCycleCount(2);
 timeline.setAutoReverse(true);
 timeline.getKeyFrames().add(new KeyFrame(Duration.millis(5000),
   new KeyValue (node.translateXProperty(), 25)));
 timeline.play();

Этот Timeline будет выполняться в течение 10 секунд, анимируя узел по оси x до значения 25, а затем обратно до 0 на втором цикле.

Предупреждение: Работающий Timeline ссылается на среду выполнения FX. Бесконечный Timeline может привести к утечке памяти, если не остановлен должным образом. Все объекты с анимируемыми свойствами не будут удалены сборщиком мусора.

Since:
JavaFX 2.0
См. также:
  • Animation
  • KeyFrame
  • KeyValue

Краткое описание свойств

Свойства, объявленные в классе javafx.animation.Animation

autoReverse, currentRate, currentTime, cycleCount, cycleDuration, delay, onFinished, rate, status, totalDuration

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в классе javafx.animation.Animation

Animation.Status

Краткое описание полей

Поля, объявленные в классе javafx.animation.Animation

INDEFINITE

Краткое описание конструкторов

Конструктор Описание
Timeline()
Создаёт Timeline без ключевых кадров.
Timeline(double targetFramerate)
Создаёт Timeline без ключевых кадров и с целевой частотой кадров.
Timeline(double targetFramerate, KeyFrame... keyFrames)
Создаёт Timeline с предоставленными ключевыми кадрами и целевой частотой кадров.
Timeline(KeyFrame... keyFrames)
Создаёт Timeline с предоставленными ключевыми кадрами.

Краткое описание методов

Модификатор и тип Метод Описание
final ObservableList<KeyFrame> getKeyFrames()
Возвращает KeyFrames этого Timeline.

Методы, объявленные в классе javafx.animation.Animation

autoReverseProperty, currentRateProperty, currentTimeProperty, cycleCountProperty, cycleDurationProperty, delayProperty, getCuePoints, getCurrentRate, getCurrentTime, getCycleCount, getCycleDuration, getDelay, getOnFinished, getRate, getStatus, getTargetFramerate, getTotalDuration, isAutoReverse, jumpTo, jumpTo, onFinishedProperty, pause, play, playFrom, playFrom, playFromStart, rateProperty, setAutoReverse, setCycleCount, setCycleDuration, setDelay, setOnFinished, setRate, setStatus, statusProperty, stop, totalDurationProperty

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

Timeline

public Timeline(double targetFramerate, KeyFrame... keyFrames)
Создаёт Timeline с предоставленными ключевыми кадрами и целевой частотой кадров. Ключевые кадры не обязательно должны быть упорядочены.
Параметры:
targetFramerate - настраиваемая целевая частота кадров для этого Timeline
keyFrames - ключевые кадры этого Timeline

Timeline

public Timeline(KeyFrame... keyFrames)
Создаёт Timeline с предоставленными ключевыми кадрами. Ключевые кадры не обязательно должны быть упорядочены.
Параметры:
keyFrames - ключевые кадры этого Timeline

Timeline

public Timeline(double targetFramerate)
Создаёт Timeline без ключевых кадров и с целевой частотой кадров.
Параметры:
targetFramerate - настраиваемая целевая частота кадров для этого Timeline

Timeline

public Timeline()
Создаёт Timeline без ключевых кадров.

Подробное описание методов

getKeyFrames

public final ObservableList<KeyFrame> getKeyFrames()
Возвращает KeyFrames этого Timeline.
Возвращает:
KeyFrames

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API