Класс Transition

java.lang.Object

javafx.animation.Animation

javafx.animation.Transition

Прямые известные подклассы:: FadeTransition, FillTransition, ParallelTransition, PathTransition, PauseTransition, RotateTransition, ScaleTransition, SequentialTransition, StrokeTransition, TranslateTransition

public abstract class Transition extends Animation

Абстрактный класс, содержащий базовые функциональные возможности, необходимые для всех анимаций, основанных на Transition, таких как PathTransition и RotateTransition.

Этот класс предлагает простую структуру для определения анимации. Он предоставляет все базовые функциональные возможности, определённые в Animation. Класс Transition требует реализации метода interpolate(double), который вызывается в каждом кадре во время выполнения Transition.

Кроме того, расширяющий класс должен задать продолжительность одного цикла с помощью Animation.setCycleDuration(javafx.util.Duration). Эта продолжительность обычно устанавливается пользователем через свойство продолжительности (как в duration), например. Но её также может рассчитать расширяющий класс, как это сделано в ParallelTransition и FadeTransition.

Ниже приведён простой пример. Он создаёт небольшую анимацию, которая обновляет свойство text узла Text. Она начинается с пустого String и постепенно добавляет буквы по одной, пока к концу анимации не будет установлено полное String.

 final String content = "Lorem ipsum";
 final Text text = new Text(10, 20, "");

 final Animation animation = new Transition() {
     {
         setCycleDuration(Duration.millis(2000));
     }

     protected void interpolate(double frac) {
         final int length = content.length();
         final int n = Math.round(length * (float) frac);
         text.setText(content.substring(0, n));
     }

 };

 animation.play();

С:

JavaFX 2.0

См. также:

Animation

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

Тип	Свойство	Описание
`final ObjectProperty<Interpolator>`	`interpolator`	Управляет временной шкалой ускорения и замедления на каждом цикле `Transition`.

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

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

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

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

Animation.Status

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

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

INDEFINITE

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

Конструктор	Описание
`Transition()`	Конструктор `Transition`.
`Transition(double targetFramerate)`	Конструктор `Transition`.

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

Модификатор и тип	Метод	Описание
`protected Interpolator`	`getCachedInterpolator()`	Возвращает `Interpolator`, который был задан при запуске `Transition`.
`final Interpolator`	`getInterpolator()`	Получает значение свойства `interpolator`.
`protected Node`	`getParentTargetNode()`	Возвращает первый узел-цель, не являющийся `null`, в иерархии родителей этого `Transition`, или `null`, если такой узел не найден.
`protected abstract void`	`interpolate(double frac)`	Метод `interpolate()` должен быть реализован подклассами `Transition`.
`final ObjectProperty<Interpolator>`	`interpolatorProperty()`	Управляет временной шкалой ускорения и замедления на каждом цикле `Transition`.
`final void`	`setInterpolator(Interpolator value)`	Устанавливает значение свойства `interpolator`.

Методы, объявленные в классе 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

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

интерполятор

public final ObjectProperty<Interpolator> interpolatorProperty

Управляет временной шкалой ускорения и замедления на каждом Transition цикле.

Это можно изменить только перед запуском перехода или после его завершения. Если значение interpolator изменяется для выполняемого Transition, анимация должна быть остановлена и запущена заново, чтобы принять новое значение.

По умолчанию интерполятор установлен на Interpolator.EASE_BOTH.

Значение по умолчанию:

EASE_BOTH

См. также:

getInterpolator()
setInterpolator(Interpolator)
interpolatorProperty()

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

Переход

public Transition(double targetFramerate)

Конструктор Transition. Этот конструктор позволяет определить target framerate.

Параметры:: targetFramerate - Пользовательская целевая частота кадров для этого Transition

Переход

public Transition()

Конструктор Transition.

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

setInterpolator

public final void setInterpolator(Interpolator value)

Устанавливает значение свойства interpolator.

Описание свойства:

Управляет временной шкалой ускорения и замедления на каждом Transition цикле.

По умолчанию интерполятор установлен на Interpolator.EASE_BOTH.

Значение по умолчанию:

EASE_BOTH

Параметры:

value - значение для свойства interpolator

См. также:

getInterpolator()
interpolatorProperty()

getInterpolator

public final Interpolator getInterpolator()

Получает значение свойства interpolator.

Описание свойства:

Управляет временной шкалой ускорения и замедления на каждом Transition цикле.

По умолчанию интерполятор установлен на Interpolator.EASE_BOTH.

Значение по умолчанию:

EASE_BOTH

Возвращает:

значение свойства interpolator

См. также:

setInterpolator(Interpolator)
interpolatorProperty()

interpolatorProperty

public final ObjectProperty<Interpolator> interpolatorProperty()

Управляет временной шкалой ускорения и замедления на каждом Transition цикле.

По умолчанию интерполятор установлен на Interpolator.EASE_BOTH.

Значение по умолчанию:

EASE_BOTH

Возвращает:

свойство interpolator

См. также:

getInterpolator()
setInterpolator(Interpolator)

getCachedInterpolator

protected Interpolator getCachedInterpolator()

Возвращает Interpolator, который был установлен при запуске Transition. Изменение interpolator выполняемого Transition не должно иметь немедленного эффекта. Вместо этого выполняемый Transition должен продолжать использовать исходный Interpolator до тех пор, пока он не будет остановлен и запущен заново.

Возвращает:: Interpolator, который был установлен при запуске этого Transition

getParentTargetNode

protected Node getParentTargetNode()

Возвращает первый не-null целевой Node в иерархии родителей этого Transition или null, если такой узел не найден.

Родительская анимация — это анимация, которая может иметь дочерние анимации. Примеры — SequentialTransition и ParallelTransition. Родительская анимация также может быть дочерней частью другой родительской анимации.

Обратите внимание, что если у этого Transition задан целевой узел и он не является родительской анимацией, он будет проигнорирован во время вызова, так как этот метод запрашивает только родительские анимации.

Возвращает:: целевой Node

interpolate

protected abstract void interpolate(double frac)

Метод interpolate() должен быть предоставлен реализациями Transition. Пока выполняется Transition, этот метод вызывается в каждом кадре. Параметр определяет текущую позицию с анимацией. В начале дробь будет 0.0, а в конце — 1.0. Как параметр увеличивается, зависит от interpolator, например, если interpolator равен Interpolator.LINEAR, дробь будет увеличиваться линейно. Этот метод не должен вызываться пользователем напрямую.

Параметры:: frac - Относительное положение

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