Класс TranslateTransition

javafx.animation.TranslateTransition

public final class TranslateTransition extends Transition

Этот Transition создаёт анимацию перемещения, которая длится в течение указанного duration. Это достигается путём обновления translateX, translateY и translateZ переменных node с заданной периодичностью.

Анимация начинается с значения (fromX, fromY, fromZ), если указано, иначе используется значение (translateX, translateY, translateZ) объекта node.

Анимация заканчивается значением (toX, toY, toZ), если указано, иначе используется начальное значение плюс (byX, byY, byZ).

Значение (toX, toY, toZ) имеет приоритет, если заданы оба значения: ( toX, toY, toZ) и (byX, byY, byZ).

Пример кода:

 
 import javafx.scene.shape.*;
 import javafx.animation.*;

 ...

     Rectangle rect = new Rectangle (100, 40, 100, 100);
     rect.setArcHeight(50);
     rect.setArcWidth(50);
     rect.setFill(Color.VIOLET);

     TranslateTransition tt = new TranslateTransition(Duration.millis(2000), rect);
     tt.setByX(200f);
     tt.setCycleCount(4f);
     tt.setAutoReverse(true);

     tt.play();

 ...

Since:

JavaFX 2.0

См. также:

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

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

Animation.Status

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

Тип	Свойство	Описание
`final DoubleProperty`	`byX`	Задает приращенное значение координаты X остановки, от начала, этого `TranslateTransition`.
`final DoubleProperty`	`byY`	Задает приращенное значение координаты Y остановки, от начала, этого `TranslateTransition`.
`final DoubleProperty`	`byZ`	Задает приращенное значение координаты Z остановки, от начала, этого `TranslateTransition`.
`final ObjectProperty<Duration>`	`duration`	Продолжительность этого `TranslateTransition`.
`final DoubleProperty`	`fromX`	Задает начальное значение координаты X этого `TranslateTransition`.
`final DoubleProperty`	`fromY`	Задает начальное значение координаты Y этого `TranslateTransition`.
`final DoubleProperty`	`fromZ`	Задает начальное значение координаты Z этого `TranslateTransition`.
`final ObjectProperty<Node>`	`node`	Целевой узел этого `TranslateTransition`.
`final DoubleProperty`	`toX`	Задает значение координаты X остановки этого `TranslateTransition`.
`final DoubleProperty`	`toY`	Задает значение координаты Y остановки этого `TranslateTransition`.
`final DoubleProperty`	`toZ`	Задает значение координаты Z остановки этого `TranslateTransition`.

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

interpolator

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

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

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

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

INDEFINITE

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

Конструктор	Описание
`TranslateTransition()`	The constructor of `TranslateTransition`
`TranslateTransition(Duration duration)`	The constructor of `TranslateTransition`
`TranslateTransition(Duration duration, Node node)`	The constructor of `TranslateTransition`

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

Modifier и Тип	Метод	Описание
`final DoubleProperty`	`byXProperty()`	Задает приращенное значение координаты X остановки, от начала, этого `TranslateTransition`.
`final DoubleProperty`	`byYProperty()`	Задает приращенное значение координаты Y остановки, от начала, этого `TranslateTransition`.
`final DoubleProperty`	`byZProperty()`	Задает приращенное значение координаты Z остановки, от начала, этого `TranslateTransition`.
`final ObjectProperty<Duration>`	`durationProperty()`	Продолжительность этого `TranslateTransition`.
`final DoubleProperty`	`fromXProperty()`	Задает начальное значение координаты X этого `TranslateTransition`.
`final DoubleProperty`	`fromYProperty()`	Задает начальное значение координаты Y этого `TranslateTransition`.
`final DoubleProperty`	`fromZProperty()`	Задает начальное значение координаты Z этого `TranslateTransition`.
`final double`	`getByX()`	Получает значение свойства `byX`.
`final double`	`getByY()`	Получает значение свойства `byY`.
`final double`	`getByZ()`	Получает значение свойства `byZ`.
`final Duration`	`getDuration()`	Получает значение свойства `duration`.
`final double`	`getFromX()`	Получает значение свойства `fromX`.
`final double`	`getFromY()`	Получает значение свойства `fromY`.
`final double`	`getFromZ()`	Получает значение свойства `fromZ`.
`final Node`	`getNode()`	Получает значение свойства `node`.
`final double`	`getToX()`	Получает значение свойства `toX`.
`final double`	`getToY()`	Получает значение свойства `toY`.
`final double`	`getToZ()`	Получает значение свойства `toZ`.
`void`	`interpolate(double frac)`	Метод `interpolate()` должен быть предоставлен реализациями `Transition`.
`final ObjectProperty<Node>`	`nodeProperty()`	Целевой узел этого `TranslateTransition`.
`final void`	`setByX(double value)`	Задает значение свойства `byX`.
`final void`	`setByY(double value)`	Задает значение свойства `byY`.
`final void`	`setByZ(double value)`	Задает значение свойства `byZ`.
`final void`	`setDuration(Duration value)`	Задает значение свойства `duration`.
`final void`	`setFromX(double value)`	Задает значение свойства `fromX`.
`final void`	`setFromY(double value)`	Задает значение свойства `fromY`.
`final void`	`setFromZ(double value)`	Задает значение свойства `fromZ`.
`final void`	`setNode(Node value)`	Задает значение свойства `node`.
`final void`	`setToX(double value)`	Задает значение свойства `toX`.
`final void`	`setToY(double value)`	Задает значение свойства `toY`.
`final void`	`setToZ(double value)`	Задает значение свойства `toZ`.
`final DoubleProperty`	`toXProperty()`	Задает значение координаты X остановки этого `TranslateTransition`.
`final DoubleProperty`	`toYProperty()`	Задает значение координаты Y остановки этого `TranslateTransition`.
`final DoubleProperty`	`toZProperty()`	Задает значение координаты Z остановки этого `TranslateTransition`.

Методы, унаследованные от класса javafx.animation.Transition

getCachedInterpolator, getInterpolator, getParentTargetNode, interpolatorProperty, setInterpolator

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

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

node

public final ObjectProperty<Node> nodeProperty

Целевой узел этого TranslateTransition.

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

См. также:

duration

public final ObjectProperty<Duration> durationProperty

Продолжительность этого TranslateTransition.

Невозможно изменить duration работающего TranslateTransition. Если значение duration изменено для работающего TranslateTransition, анимацию необходимо остановить и запустить снова, чтобы принять новое значение.

Примечание. Хотя единицей duration является миллисекунда, детализация зависит от базовой операционной системы и, как правило, будет больше. Например, анимация в настольных системах обычно выполняется с максимальной частотой 60 кадров в секунду, что дает детализацию ~17 мс. Установка duration на значение ниже Duration.ZERO приведет к IllegalArgumentException.

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

400 мс

См. также:

fromX

public final DoubleProperty fromXProperty

Указывает начальное значение координаты X этого TranslateTransition.

Невозможно изменить fromX работающего TranslateTransition. Если значение fromX изменено для работающего TranslateTransition, анимацию необходимо остановить и запустить снова, чтобы принять новое значение.

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

Double.NaN

См. также:

fromY

public final DoubleProperty fromYProperty

Указывает начальное значение координаты Y этого TranslateTransition.

Невозможно изменить fromY работающего TranslateTransition. Если значение fromY изменено для работающего TranslateTransition, анимацию необходимо остановить и запустить снова, чтобы принять новое значение.

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

Double.NaN

См. также:

fromZ

public final DoubleProperty fromZProperty

Указывает начальное значение координаты Z этого TranslateTransition.

Невозможно изменить fromZ работающего TranslateTransition. Если значение fromZ изменено для работающего TranslateTransition, анимацию необходимо остановить и запустить снова, чтобы принять новое значение.

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

Double.NaN

См. также:

toX

public final DoubleProperty toXProperty

Указывает конечное значение координаты X этого TranslateTransition.

Невозможно изменить toX работающего TranslateTransition. Если значение toX изменено для работающего TranslateTransition, анимацию необходимо остановить и запустить снова, чтобы принять новое значение.

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

Double.NaN

См. также:

toY

public final DoubleProperty toYProperty

Указывает конечное значение координаты Y этого TranslateTransition.

Невозможно изменить toY работающего TranslateTransition. Если значение toY изменено для работающего TranslateTransition, анимацию необходимо остановить и запустить снова, чтобы принять новое значение.

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

Double.NaN

См. также:

toZ

public final DoubleProperty toZProperty

Указывает конечное значение координаты Z этого TranslateTransition.

Невозможно изменить toZ работающего TranslateTransition. Если значение toZ изменено для работающего TranslateTransition, анимацию необходимо остановить и запустить снова, чтобы принять новое значение.

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

Double.NaN

См. также:

byX

public final DoubleProperty byXProperty

Указывает увеличенное конечное значение координаты X, от начальной точки, этого TranslateTransition.

Невозможно изменить byX работающего TranslateTransition. Если значение byX изменено для работающего TranslateTransition, анимацию необходимо остановить и запустить снова, чтобы принять новое значение.

См. также:

byY

public final DoubleProperty byYProperty

Указывает увеличенное конечное значение координаты Y, от начальной точки, этого TranslateTransition.

Невозможно изменить byY работающего TranslateTransition. Если значение byY изменено для работающего TranslateTransition, анимацию необходимо остановить и запустить снова, чтобы принять новое значение.

См. также:

byZ

public final DoubleProperty byZProperty

Указывает увеличенное конечное значение координаты Z, от начальной точки, этого TranslateTransition.

Невозможно изменить byZ работающего TranslateTransition. Если значение byZ изменено для работающего TranslateTransition, анимацию необходимо остановить и запустить снова, чтобы принять новое значение.

См. также:

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

TranslateTransition

public TranslateTransition(Duration duration, Node node)

Конструктор TranslateTransition

Параметры:: duration - Продолжительность TranslateTransition; node - node, который будет преобразован

TranslateTransition

public TranslateTransition(Duration duration)

Конструктор TranslateTransition

Параметры:: duration - Продолжительность TranslateTransition

TranslateTransition

public TranslateTransition()

Конструктор TranslateTransition

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

Установить узел

public final void setNode(Node value)

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

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

Целевой узел для этого TranslateTransition.

Изменить целевой node работающего TranslateTransition невозможно. Если значение node изменяется для работающей TranslateTransition, для получения нового значения анимацию необходимо остановить и запустить заново.

Параметры:

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

См. также:

Получить узел

public final Node getNode()

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

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

Целевой узел для этого TranslateTransition.

Возвращает:

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

См. также:

свойство узла

public final ObjectProperty<Node> nodeProperty()

Целевой узел для этого TranslateTransition.

Возвращает:

свойство node

См. также:

Установить длительность

public final void setDuration(Duration value)

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

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

Длительность этой TranslateTransition.

Изменить длительность работающей TranslateTransition невозможно. Если значение duration изменяется для работающей TranslateTransition, для получения нового значения анимацию необходимо остановить и запустить заново.

Примечание: Хотя единицей измерения duration является миллисекунда, точность зависит от используемой операционной системы и, как правило, будет больше. Например, анимация на настольных системах обычно выполняется с максимальной частотой 60 кадров в секунду, что обеспечивает точность ~17 мс. Установка длительности со значением меньше Duration.ZERO приведет к IllegalArgumentException.

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

400мс

Параметры:

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

См. также:

Получить длительность

public final Duration getDuration()

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

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

Длительность этой TranslateTransition.

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

400мс

Возвращает:

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

См. также:

свойство длительности

public final ObjectProperty<Duration> durationProperty()

Длительность этой TranslateTransition.

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

400мс

Возвращает:

свойство duration

См. также:

Установить начальную координату X

public final void setFromX(double value)

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

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

Задает начальную координату X для этой TranslateTransition.

Изменить fromX работающей TranslateTransition невозможно. Если значение fromX изменяется для работающей TranslateTransition, для получения нового значения анимацию необходимо остановить и запустить заново.

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

Double.NaN

Параметры:

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

См. также:

Получить начальную координату X

public final double getFromX()

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

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

Задает начальную координату X для этой TranslateTransition.

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

Double.NaN

Возвращает:

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

См. также:

свойство начальной координаты X

public final DoubleProperty fromXProperty()

Задает начальную координату X для этой TranslateTransition.

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

Double.NaN

Возвращает:

свойство fromX

См. также:

Установить начальную координату Y

public final void setFromY(double value)

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

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

Задает начальную координату Y для этой TranslateTransition.

Изменить fromY работающей TranslateTransition невозможно. Если значение fromY изменяется для работающей TranslateTransition, для получения нового значения анимацию необходимо остановить и запустить заново.

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

Double.NaN

Параметры:

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

См. также:

getFromY

public final double getFromY()

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

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

Указывает начальное значение координаты Y для этого TranslateTransition.

Изменить значение fromY работающего TranslateTransition невозможно. Если значение fromY изменяется для работающего TranslateTransition, для получения нового значения анимацию необходимо остановить и запустить снова.

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

Double.NaN

Возвращает:

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

См. также:

fromYProperty

public final DoubleProperty fromYProperty()

Указывает начальное значение координаты Y для этого TranslateTransition.

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

Double.NaN

Возвращает:

свойство fromY

См. также:

setFromZ

public final void setFromZ(double value)

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

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

Указывает начальное значение координаты Z для этого TranslateTransition.

Изменить значение fromZ работающего TranslateTransition невозможно. Если значение fromZ изменяется для работающего TranslateTransition, для получения нового значения анимацию необходимо остановить и запустить снова.

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

Double.NaN

Параметры:

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

См. также:

getFromZ

public final double getFromZ()

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

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

Указывает начальное значение координаты Z для этого TranslateTransition.

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

Double.NaN

Возвращает:

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

См. также:

fromZProperty

public final DoubleProperty fromZProperty()

Указывает начальное значение координаты Z для этого TranslateTransition.

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

Double.NaN

Возвращает:

свойство fromZ

См. также:

setToX

public final void setToX(double value)

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

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

Указывает конечное значение координаты X для этого TranslateTransition.

Изменить значение toX работающего TranslateTransition невозможно. Если значение toX изменяется для работающего TranslateTransition, для получения нового значения анимацию необходимо остановить и запустить снова.

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

Double.NaN

Параметры:

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

См. также:

getToX

public final double getToX()

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

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

Указывает конечное значение координаты X для этого TranslateTransition.

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

Double.NaN

Возвращает:

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

См. также:

toXProperty

public final DoubleProperty toXProperty()

Указывает конечное значение координаты X для этого TranslateTransition.

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

Double.NaN

Возвращает:

свойство toX

См. также:

setToY

public final void setToY(double value)

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

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

Указывает конечное значение координаты Y для этого TranslateTransition.

Изменить значение toY работающего TranslateTransition невозможно. Если значение toY изменяется для работающего TranslateTransition, для получения нового значения анимацию необходимо остановить и запустить снова.

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

Double.NaN

Параметры:

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

См. также:

getToY

public final double getToY()

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

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

Указывает конечное значение координаты Y для этого TranslateTransition.

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

Double.NaN

Возвращает:

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

См. также:

toYProperty

public final DoubleProperty toYProperty()

Указывает конечное значение координаты Y для этого TranslateTransition.

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

Double.NaN

Возвращает:

свойство toY

См. также:

setToZ

public final void setToZ(double value)

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

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

Указывает конечное значение координаты Z для этого TranslateTransition.

Изменить значение toZ работающего TranslateTransition невозможно. Если значение toZ изменяется для работающего TranslateTransition, для получения нового значения анимацию необходимо остановить и запустить снова.

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

Double.NaN

Параметры:

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

См. также:

getToZ

public final double getToZ()

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

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

Задает значение координаты Z остановки этого TranslateTransition.

Нельзя изменить toZ выполняемого TranslateTransition. Если значение toZ изменяется для выполняемого TranslateTransition, анимацию необходимо остановить и перезапустить, чтобы получить новое значение.

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

Double.NaN

Возвращает:

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

См. также:

toZProperty

public final DoubleProperty toZProperty()

Задает значение координаты Z остановки этого TranslateTransition.

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

Double.NaN

Возвращает:

свойство toZ

См. также:

setByX

public final void setByX(double value)

Задает значение свойства byX.

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

Задает приращенное значение координаты X остановки, от начала, этого TranslateTransition.

Нельзя изменить byX выполняемого TranslateTransition. Если значение byX изменяется для выполняемого TranslateTransition, анимацию необходимо остановить и перезапустить, чтобы получить новое значение.

Параметры:

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

См. также:

getByX

public final double getByX()

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

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

Задает приращенное значение координаты X остановки, от начала, этого TranslateTransition.

Возвращает:

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

См. также:

byXProperty

public final DoubleProperty byXProperty()

Задает приращенное значение координаты X остановки, от начала, этого TranslateTransition.

Возвращает:

свойство byX

См. также:

setByY

public final void setByY(double value)

Задает значение свойства byY.

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

Задает приращенное значение координаты Y остановки, от начала, этого TranslateTransition.

Нельзя изменить byY выполняемого TranslateTransition. Если значение byY изменяется для выполняемого TranslateTransition, анимацию необходимо остановить и перезапустить, чтобы получить новое значение.

Параметры:

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

См. также:

getByY

public final double getByY()

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

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

Задает приращенное значение координаты Y остановки, от начала, этого TranslateTransition.

Возвращает:

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

См. также:

byYProperty

public final DoubleProperty byYProperty()

Задает приращенное значение координаты Y остановки, от начала, этого TranslateTransition.

Возвращает:

свойство byY

См. также:

setByZ

public final void setByZ(double value)

Задает значение свойства byZ.

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

Задает приращенное значение координаты Z остановки, от начала, этого TranslateTransition.

Нельзя изменить byZ выполняемого TranslateTransition. Если значение byZ изменяется для выполняемого TranslateTransition, анимацию необходимо остановить и перезапустить, чтобы получить новое значение.

Параметры:

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

См. также:

getByZ

public final double getByZ()

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

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

Задает приращенное значение координаты Z остановки, от начала, этого TranslateTransition.

Возвращает:

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

См. также:

byZProperty

public final DoubleProperty byZProperty()

Задает приращенное значение координаты Z остановки, от начала, этого TranslateTransition.

Возвращает:

свойство byZ

См. также:

interpolate

public void interpolate(double frac)

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

Указано в:: interpolate в классе Transition
Параметры:: 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.