Класс FadeTransition

javafx.animation.FadeTransition

public final class FadeTransition extends Transition

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

Она стартует с значения fromValue, если оно предоставлено, иначе использует значение node's opacity.

Она останавливается на значении toValue, если оно предоставлено, иначе она будет использовать начальное значение плюс byValue.

Значение toValue имеет приоритет, если оба toValue и byValue заданы.

Пример кода:

 
 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);

     FadeTransition ft = new FadeTransition(Duration.millis(3000), rect);
     ft.setFromValue(1.0);
     ft.setToValue(0.3);
     ft.setCycleCount(4);
     ft.setAutoReverse(true);

     ft.play();

 ...

С момента:

JavaFX 2.0

См. также:

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

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

Animation.Status

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

Тип	Свойство	Описание
`final DoubleProperty`	`byValue`	Указывает значение увеличенной непрозрачности остановки, от начала, данного `FadeTransition`.
`final ObjectProperty<Duration>`	`duration`	Продолжительность данного `FadeTransition`.
`final DoubleProperty`	`fromValue`	Указывает начальное значение непрозрачности для данного `FadeTransition`.
`final ObjectProperty<Node>`	`node`	Узел назначения данного `Transition`.
`final DoubleProperty`	`toValue`	Указывает значение непрозрачности остановки для данного `FadeTransition`.

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

interpolator

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

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

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

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

INDEFINITE

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

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

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

Модификатор и тип	Метод	Описание
`final DoubleProperty`	`byValueProperty()`	Указывает значение увеличенной непрозрачности остановки, от начала, данного `FadeTransition`.
`final ObjectProperty<Duration>`	`durationProperty()`	Продолжительность данного `FadeTransition`.
`final DoubleProperty`	`fromValueProperty()`	Указывает начальное значение непрозрачности для данного `FadeTransition`.
`final double`	`getByValue()`	Получает значение свойства `byValue`.
`final Duration`	`getDuration()`	Получает значение свойства `duration`.
`final double`	`getFromValue()`	Получает значение свойства `fromValue`.
`final Node`	`getNode()`	Получает значение свойства `node`.
`final double`	`getToValue()`	Получает значение свойства `toValue`.
`protected void`	`interpolate(double frac)`	Метод `interpolate()` должен быть предоставлен реализациями `Transition`.
`final ObjectProperty<Node>`	`nodeProperty()`	Узел назначения данного `Transition`.
`final void`	`setByValue(double value)`	Устанавливает значение свойства `byValue`.
`final void`	`setDuration(Duration value)`	Устанавливает значение свойства `duration`.
`final void`	`setFromValue(double value)`	Устанавливает значение свойства `fromValue`.
`final void`	`setNode(Node value)`	Устанавливает значение свойства `node`.
`final void`	`setToValue(double value)`	Устанавливает значение свойства `toValue`.
`final DoubleProperty`	`toValueProperty()`	Указывает значение непрозрачности остановки для данного `FadeTransition`.

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

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

узел

public final ObjectProperty<Node> nodeProperty

Целевой узел данного Transition.

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

См. также:

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

public final ObjectProperty<Duration> durationProperty

Продолжительность этой FadeTransition.

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

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

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

400 мс

См. также:

отЗначение

public final DoubleProperty fromValueProperty

Указывает начальное значение непрозрачности для данного FadeTransition.

Изменить fromValue запущенной FadeTransition невозможно. Если значение fromValue изменено для запущенной FadeTransition, анимация должна быть остановлена и запущена заново, чтобы принять новое значение.

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

Double.NaN

См. также:

конечноеЗначение

public final DoubleProperty toValueProperty

Указывает конечное значение непрозрачности для этой FadeTransition.

Изменить toValue запущенной FadeTransition невозможно. Если значение toValue изменено для запущенной FadeTransition, анимация должна быть остановлена и запущена заново, чтобы принять новое значение.

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

Double.NaN

См. также:

значениeНаПриращение

public final DoubleProperty byValueProperty

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

Изменить byValue запущенной FadeTransition невозможно. Если значение byValue изменено для запущенной FadeTransition, анимация должна быть остановлена и запущена заново, чтобы принять новое значение.

См. также:

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

FadeTransition

public FadeTransition(Duration duration, Node node)

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

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

FadeTransition

public FadeTransition(Duration duration)

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

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

FadeTransition

public FadeTransition()

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

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

setNode

public final void setNode(Node value)

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

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

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

Параметры:

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

См. также:

getNode

public final Node getNode()

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

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

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

Возвращает:

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

См. также:

nodeProperty

public final ObjectProperty<Node> nodeProperty()

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

Возвращает:

свойство node

См. также:

setDuration

public final void setDuration(Duration value)

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

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

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

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

400 мс

Параметры:

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

См. также:

getDuration

public final Duration getDuration()

Возвращает значение свойства duration.

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

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

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

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

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

400ms

Возвращает:

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

См. также:

durationProperty

public final ObjectProperty<Duration> durationProperty()

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

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

400ms

Возвращает:

свойство duration

См. также:

setFromValue

public final void setFromValue(double value)

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

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

Задает начальное значение непрозрачности для этого FadeTransition.

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

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

Double.NaN

Параметры:

value - значение свойства fromValue

См. также:

getFromValue

public final double getFromValue()

Возвращает значение свойства fromValue.

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

Задает начальное значение непрозрачности для этого FadeTransition.

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

Double.NaN

Возвращает:

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

См. также:

fromValueProperty

public final DoubleProperty fromValueProperty()

Задает начальное значение непрозрачности для этого FadeTransition.

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

Double.NaN

Возвращает:

свойство fromValue

См. также:

setToValue

public final void setToValue(double value)

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

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

Задает конечное значение непрозрачности для этого FadeTransition.

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

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

Double.NaN

Параметры:

value - значение свойства toValue

См. также:

getToValue

public final double getToValue()

Возвращает значение свойства toValue.

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

Задает конечное значение непрозрачности для этого FadeTransition.

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

Double.NaN

Возвращает:

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

См. также:

toValueProperty

public final DoubleProperty toValueProperty()

Задает конечное значение непрозрачности для этого FadeTransition.

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

Double.NaN

Возвращает:

свойство toValue

См. также:

setByValue

public final void setByValue(double value)

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

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

Задает увеличенное значение конечной непрозрачности от начала этого FadeTransition.

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

Параметры:

value - значение свойства byValue

См. также:

getByValue

public final double getByValue()

Возвращает значение свойства byValue.

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

Задает увеличенное значение конечной непрозрачности от начала этого FadeTransition.

Возвращает:

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

См. также:

byValueProperty

public final DoubleProperty byValueProperty()

Задает увеличенное значение конечной непрозрачности от начала этого FadeTransition.

Возвращает:

свойство byValue

См. также:

interpolate

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