Класс TranslateTransition

javafx.animation.TranslateTransition

public final class TranslateTransition
extends Transition

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

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

Анимация останавливается на значении (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
См. также:: Transition, Animation

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

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

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

interpolator

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

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

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

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

Animation.Status

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

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

INDEFINITE

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

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

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

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

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

getCachedInterpolator, getInterpolator, getParentTargetNode, interpolate, 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

Подробности свойств

узел

public final ObjectProperty<Node> nodeProperty

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

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

См. также:: getNode(), setNode(Node)

продолжительность

public final ObjectProperty<Duration> durationProperty

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

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

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

Значение по умолчанию:: 400мс
См. также:: getDuration(), setDuration(Duration)

fromX

public final DoubleProperty fromXProperty

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

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

Значение по умолчанию:: Double.NaN
См. также:: getFromX(), setFromX(double)

fromY

public final DoubleProperty fromYProperty

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

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

Значение по умолчанию:: Double.NaN
См. также:: getFromY(), setFromY(double)

fromZ

public final DoubleProperty fromZProperty

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

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

Значение по умолчанию:: Double.NaN
См. также:: getFromZ(), setFromZ(double)

toX

public final DoubleProperty toXProperty

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

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

Значение по умолчанию:: Double.NaN
См. также:: getToX(), setToX(double)

toY

public final DoubleProperty toYProperty

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

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

Значение по умолчанию:: Double.NaN
См. также:: getToY(), setToY(double)

toZ

public final DoubleProperty toZProperty

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

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

Значение по умолчанию:: Double.NaN
См. также:: getToZ(), setToZ(double)

byX

public final DoubleProperty byXProperty

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

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

См. также:: getByX(), setByX(double)

byY

public final DoubleProperty byYProperty

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

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

См. также:: getByY(), setByY(double)

byZ

public final DoubleProperty byZProperty

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

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

См. также:: getByZ(), setByZ(double)

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

TranslateTransition

public TranslateTransition(Duration duration, Node node)

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

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

TranslateTransition

public TranslateTransition(Duration duration)

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

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

TranslateTransition

public TranslateTransition()

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

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

setNode

public final void setNode(Node value)

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

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

getNode

public final Node getNode()

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

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

nodeProperty

public final ObjectProperty<Node> nodeProperty()

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

См. также:: getNode(), setNode(Node)

установитьДлительность

public final void setDuration(Duration value)

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

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

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

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

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

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

400 мс

получитьДлительность

public final Duration getDuration()

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

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

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

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

400 мс

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

public final ObjectProperty<Duration> durationProperty()

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

Значение по умолчанию:: 400 мс
См. также:: getDuration(), setDuration(Duration)

установитьОтX

public final void setFromX(double value)

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

Описание свойства:: Указывает начальное значение координаты X для этого TranslateTransition.
Невозможно изменить начальное значение координаты X выполняемого TranslateTransition. Если значение fromX изменяется для выполняемого TranslateTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
Значение по умолчанию:: Double.NaN

получитьОтX

public final double getFromX()

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

Описание свойства:: Указывает начальное значение координаты X для этого TranslateTransition.
Невозможно изменить начальное значение координаты X выполняемого TranslateTransition. Если значение fromX изменяется для выполняемого TranslateTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
Значение по умолчанию:: Double.NaN

свойствоОтX

public final DoubleProperty fromXProperty()

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

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

Значение по умолчанию:: Double.NaN
См. также:: getFromX(), setFromX(double)

установитьОтY

public final void setFromY(double value)

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

Описание свойства:: Указывает начальное значение координаты Y для этого TranslateTransition.
Невозможно изменить начальное значение координаты Y выполняемого TranslateTransition. Если значение fromY изменяется для выполняемого TranslateTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
Значение по умолчанию:: Double.NaN

получитьОтY

public final double getFromY()

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

Описание свойства:: Указывает начальное значение координаты Y для этого TranslateTransition.
Невозможно изменить начальное значение координаты Y выполняемого TranslateTransition. Если значение fromY изменяется для выполняемого TranslateTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
Значение по умолчанию:: Double.NaN

свойствоОтY

public final DoubleProperty fromYProperty()

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

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

Значение по умолчанию:: Double.NaN
См. также:: getFromY(), setFromY(double)

установитьОтZ

public final void setFromZ(double value)

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

Описание свойства:: Указывает начальное значение координаты Z для этого TranslateTransition.
Невозможно изменить начальное значение координаты Z выполняемого TranslateTransition. Если значение fromZ изменяется для выполняемого TranslateTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
Значение по умолчанию:: Double.NaN

получитьОтZ

public final double getFromZ()

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

Описание свойства:: Указывает начальное значение координаты Z для этого TranslateTransition.
Невозможно изменить начальное значение координаты Z выполняемого TranslateTransition. Если значение fromZ изменяется для выполняемого TranslateTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
Значение по умолчанию:: Double.NaN

свойствоОтZ

public final DoubleProperty fromZProperty()

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

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

Значение по умолчанию:: Double.NaN
См. также:: getFromZ(), setFromZ(double)

установитьКX

public final void setToX(double value)

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

Описание свойства:: Указывает конечное значение координаты X для этого TranslateTransition.
Невозможно изменить конечное значение координаты X выполняемого TranslateTransition. Если значение toX изменяется для выполняемого TranslateTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
Значение по умолчанию:: Double.NaN

получитьКX

public final double getToX()

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

Описание свойства:: Указывает конечное значение координаты X для этого TranslateTransition.
Невозможно изменить конечное значение координаты X выполняемого TranslateTransition. Если значение toX изменяется для выполняемого TranslateTransition, анимация должна быть остановлена и запущена снова, чтобы принять новое значение.
Значение по умолчанию:: Double.NaN

свойствоКX

public final DoubleProperty toXProperty()

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

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

Значение по умолчанию:: Double.NaN
См. также:: getToX(), setToX(double)

setToY

public final void setToY(double value)

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

Описание свойства:: Указывает значение координаты Y остановки для этого TranslateTransition.
Изменение значения toY для активного TranslateTransition невозможно. Если значение toY изменено для активной анимации TranslateTransition, необходимо остановить и снова запустить анимацию, чтобы она приняла новое значение.
Значение по умолчанию:: Double.NaN

getToY

public final double getToY()

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

Описание свойства:: Указывает значение координаты Y остановки для этого TranslateTransition.
Изменение значения toY для активной анимации TranslateTransition невозможно. Если значение toY изменено для активной анимации TranslateTransition, необходимо остановить и снова запустить анимацию, чтобы она приняла новое значение.
Значение по умолчанию:: Double.NaN

toYProperty

public final DoubleProperty toYProperty()

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

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

Значение по умолчанию:: Double.NaN
См. также:: getToY(), setToY(double)

setToZ

public final void setToZ(double value)

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

Описание свойства:: Указывает значение координаты Z остановки для этого TranslateTransition.
Изменение значения toZ для активной анимации TranslateTransition невозможно. Если значение toZ изменено для активной анимации TranslateTransition, необходимо остановить и снова запустить анимацию, чтобы она приняла новое значение.
Значение по умолчанию:: Double.NaN

getToZ

public final double getToZ()

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

Описание свойства:: Указывает значение координаты Z остановки для этого TranslateTransition.
Изменение значения toZ для активной анимации TranslateTransition невозможно. Если значение toZ изменено для активной анимации TranslateTransition, необходимо остановить и снова запустить анимацию, чтобы она приняла новое значение.
Значение по умолчанию:: Double.NaN

toZProperty

public final DoubleProperty toZProperty()

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

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

Значение по умолчанию:: Double.NaN
См. также:: getToZ(), setToZ(double)

setByX

public final void setByX(double value)

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

Описание свойства:: Указывает приращение координаты X остановки, от начала, для этого TranslateTransition.
Изменение значения byX для активной анимации TranslateTransition невозможно. Если значение byX изменено для активной анимации TranslateTransition, необходимо остановить и снова запустить анимацию, чтобы она приняла новое значение.

getByX

public final double getByX()

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

Описание свойства:: Указывает приращение координаты X остановки, от начала, для этого TranslateTransition.
Изменение значения byX для активной анимации TranslateTransition невозможно. Если значение byX изменено для активной анимации TranslateTransition, необходимо остановить и снова запустить анимацию, чтобы она приняла новое значение.

byXProperty

public final DoubleProperty byXProperty()

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

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

См. также:: getByX(), setByX(double)

setByY

public final void setByY(double value)

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

Описание свойства:: Указывает приращение координаты Y остановки, от начала, для этого TranslateTransition.
Изменение значения byY для активной анимации TranslateTransition невозможно. Если значение byY изменено для активной анимации TranslateTransition, необходимо остановить и снова запустить анимацию, чтобы она приняла новое значение.

getByY

public final double getByY()

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

Описание свойства:: Указывает приращение координаты Y остановки, от начала, для этого TranslateTransition.
Изменение значения byY для активной анимации TranslateTransition невозможно. Если значение byY изменено для активной анимации TranslateTransition, необходимо остановить и снова запустить анимацию, чтобы она приняла новое значение.

byYProperty

public final DoubleProperty byYProperty()

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

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

См. также:: getByY(), setByY(double)

setByZ

public final void setByZ(double value)

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

Описание свойства:: Указывает приращение координаты Z остановки, от начала, для этого TranslateTransition.
Изменение значения byZ для активной анимации TranslateTransition невозможно. Если значение byZ изменено для активной анимации TranslateTransition, необходимо остановить и снова запустить анимацию, чтобы она приняла новое значение.

getByZ

public final double getByZ()

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

Описание свойства:: Указывает приращение координаты Z остановки, от начала, для этого TranslateTransition.
Изменение значения byZ для активной анимации TranslateTransition невозможно. Если значение byZ изменено для активной анимации TranslateTransition, необходимо остановить и снова запустить анимацию, чтобы она приняла новое значение.

byZProperty

public final DoubleProperty byZProperty()

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

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

См. также:: getByZ(), setByZ(double)

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