Spec-Zone.ru › OpenJavaFX 8
javafx.animation

Класс Animation

java.lang.Object
  • javafx.animation.Animation

Прямые известные подклассы:

Timeline, Transition



public abstract class Animation
extends Object
Класс Animation предоставляет основные функции всех анимаций, используемых в среде JavaFX.

Анимацию можно запускать циклически, установив значение cycleCount. Чтобы анимация выполнялась вперёд и назад при циклическом воспроизведении, установите флаг autoReverse.

Вызовите play() или playFromStart() для запуска Animation. Animation выполняется в направлении и со скоростью, заданными параметром rate, и останавливается по истечении её длительности. Animation с неопределенной длительностью (с cycleCount значением INDEFINITE) выполняется повторно, пока явно не будет вызван метод stop(), который остановит запущенную Animation и сбросит её позицию воспроизведения до начального состояния.

Animation можно приостановить, вызвав pause(), и следующий вызов play() возобновит Animation с места остановки.

Позиция воспроизведения Animation может быть установлена произвольно, независимо от того, запущена она или нет. Если Animation запущена, позиция воспроизведения мгновенно переходит в указанную позицию и продолжает воспроизведение с новой позиции. Если Animation не запущена, следующий вызов play() запустит Animation с указанной позиции.

Инвертирование значения rate переключает направление воспроизведения.

С момента:

JavaFX 2.0

См. также:

Timeline, Transition

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

    Все методыМетоды экземпляровКонкретные методы
    Тип Свойство и описание
    BooleanProperty autoReverse
    Определяет, меняет ли этот Animation направление на чередующихся циклах.
    ReadOnlyDoubleProperty currentRate
    Только для чтения переменная, указывающая текущее направление/скорость воспроизведения Animation.
    ReadOnlyObjectProperty<Duration> currentTime
    Определяет положение головки воспроизведения Animation.
    IntegerProperty cycleCount
    Определяет количество циклов в этом анимационном файле.
    ReadOnlyObjectProperty<Duration> cycleDuration
    Только для чтения переменная, указывающая продолжительность одного цикла этого Animation: время, необходимое для воспроизведения с момента 0 до конца анимации (при стандартном значении rate 1.0).
    ObjectProperty<Duration> delay
    Задерживает запуск анимации.
    ObjectProperty<EventHandler<ActionEvent>> onFinished
    Действие, которое должно быть выполнено по завершении этого Animation.
    DoubleProperty rate
    Определяет направление/скорость, с которой ожидается воспроизведение Animation.
    ReadOnlyObjectProperty<Animation.Status> status
    Статус Animation.
    ReadOnlyObjectProperty<Duration> totalDuration
    Только для чтения переменная, указывающая общую продолжительность этого Animation, включая повторы.
  • Краткое описание вложенных классов

    Вложенные классы
    Модификатор и тип Класс и описание
    static class  Animation.Status
    Возможные состояния для status.
  • Краткое описание полей

    Поля
    Модификатор и тип Поле и описание
    static int INDEFINITE
    Используется для указания анимации, которая повторяется бесконечно, пока не будет вызван метод stop().
  • Краткое описание конструкторов

    Конструкторы
    Модификатор Конструктор и описание
    protected Animation()
    Конструктор Animation.
    protected Animation(double targetFramerate)
    Конструктор Animation.
  • Краткое описание методов

    Все методыМетоды экземпляровКонкретные методы
    Модификатор и тип Метод и описание
    BooleanProperty autoReverseProperty()
    Определяет, меняет ли этот Animation направление на чередующихся циклах.
    ReadOnlyDoubleProperty currentRateProperty()
    Только для чтения переменная, указывающая текущее направление/скорость воспроизведения Animation.
    ReadOnlyObjectProperty<Duration> currentTimeProperty()
    Определяет положение головки воспроизведения Animation.
    IntegerProperty cycleCountProperty()
    Определяет количество циклов в этой анимации.
    ReadOnlyObjectProperty<Duration> cycleDurationProperty()
    Только для чтения переменная, указывающая продолжительность одного цикла этого Animation: время, необходимое для воспроизведения с момента 0 до конца анимации (при стандартном значении rate 1.0).
    ObjectProperty<Duration> delayProperty()
    Задерживает запуск анимации.
    ObservableMap<String,Duration> getCuePoints()
    Отметки времени могут использоваться для обозначения важных позиций в Animation.
    double getCurrentRate()
    Получает значение свойства currentRate.
    Duration getCurrentTime()
    Получает значение свойства currentTime.
    int getCycleCount()
    Получает значение свойства cycleCount.
    Duration getCycleDuration()
    Получает значение свойства cycleDuration.
    Duration getDelay()
    Получает значение свойства delay.
    EventHandler<ActionEvent> getOnFinished()
    Получает значение свойства onFinished.
    double getRate()
    Получает значение свойства rate.
    Animation.Status getStatus()
    Получает значение свойства status.
    double getTargetFramerate()
    Целевая частота кадров — это максимальная частота кадров, с которой будет выполняться этот Animation в кадрах в секунду.
    Duration getTotalDuration()
    Получает значение свойства totalDuration.
    boolean isAutoReverse()
    Получает значение свойства autoReverse.
    void jumpTo(Duration time)
    Переходит к заданной позиции в этом Animation.
    void jumpTo(String cuePoint)
    Переходит к предопределенной позиции в этом Animation.
    ObjectProperty<EventHandler<ActionEvent>> onFinishedProperty()
    Действие, которое должно быть выполнено по завершении этого Animation.
    void pause()
    Приостанавливает анимацию.
    void play()
    Воспроизводит Animation с текущей позиции в направлении, указанном rate.
    void playFrom(Duration time)
    Удобный метод для воспроизведения этого Animation с определенной позиции.
    void playFrom(String cuePoint)
    Удобный метод для воспроизведения этого Animation с предопределенной позиции.
    void playFromStart()
    Воспроизводит Animation с начальной позиции в прямом направлении.
    DoubleProperty rateProperty()
    Определяет направление/скорость, с которой ожидается воспроизведение Animation.
    void setAutoReverse(boolean value)
    Устанавливает значение свойства autoReverse.
    void setCycleCount(int value)
    Устанавливает значение свойства cycleCount.
    protected void setCycleDuration(Duration value)
    Устанавливает значение свойства cycleDuration.
    void setDelay(Duration value)
    Устанавливает значение свойства delay.
    void setOnFinished(EventHandler<ActionEvent> value)
    Устанавливает значение свойства onFinished.
    void setRate(double value)
    Устанавливает значение свойства rate.
    protected void setStatus(Animation.Status value)
    Устанавливает значение свойства status.
    ReadOnlyObjectProperty<Animation.Status> statusProperty()
    Статус Animation.
    void stop()
    Останавливает анимацию и сбрасывает головку воспроизведения в начальную позицию.
    ReadOnlyObjectProperty<Duration> totalDurationProperty()
    Только для чтения переменная, указывающая общую продолжительность этого Animation, включая повторы.
    • Наследуемые методы из класса java.lang.Object

      clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Подробное описание свойств

    • rate

      public final DoubleProperty rateProperty
      Определяет направление/скорость воспроизведения Animation.

      Абсолютное значение rate указывает скорость воспроизведения Animation, а знак rate — направление. Положительное значение rate указывает на прямое воспроизведение, отрицательное — на обратное воспроизведение, а значение 0.0 останавливает воспроизведение Animation.

      Скорость 1.0 — это нормальное воспроизведение, 2.0 — 2 раза быстрее нормы, -1.0 — обратное воспроизведение и т. д.

      Изменение скорости воспроизведения активного Animation приведет к изменению направления воспроизведения Animation на месте и обратной прокрутке части Animation, которая уже воспроизведена.

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

      1.0

      См. также:

      getRate(), setRate(double)

    • currentRate

      public final ReadOnlyDoubleProperty currentRateProperty
      Только для чтения переменная, указывающая текущее направление/скорость воспроизведения Animation.

      currentRate не обязательно равно rate. currentRate устанавливается в 0.0, когда анимация приостановлена или остановлена. currentRate может также указывать на другое направление во время обратных циклов, когда autoReverse является true

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

      0.0

      См. также:

      getCurrentRate()

    • cycleDuration

      public final ReadOnlyObjectProperty<Duration> cycleDurationProperty
      Только для чтения переменная, указывающая длительность одного цикла этой Animation: время, необходимое для воспроизведения от момента 0 до конца анимации (при стандартном значении rate 1.0).

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

      0мс

      См. также:

      getCycleDuration(), setCycleDuration(Duration)

    • totalDuration

      public final ReadOnlyObjectProperty<Duration> totalDurationProperty
      Только для чтения переменная, указывающая общую продолжительность этой Animation, включая повторения. Animation с cycleCount Animation.INDEFINITE будет иметь totalDuration Duration.INDEFINITE.

      Это значение устанавливается как cycleDuration * cycleCount.

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

      0мс

      См. также:

      getTotalDuration()

    • currentTime

      public final ReadOnlyObjectProperty<Duration> currentTimeProperty
      Определяет положение воспроизведения Animation.

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

      0мс

      См. также:

      getCurrentTime()

    • delay

      public final ObjectProperty<Duration> delayProperty
      Задержка начала анимации. Не может быть отрицательной. Установка отрицательного значения приведет к IllegalArgumentException.

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

      0мс

      См. также:

      getDelay(), setDelay(Duration)

    • cycleCount

      public final IntegerProperty cycleCountProperty
      Определяет количество циклов в этой анимации. cycleCount может быть INDEFINITE для анимаций, которые повторяются бесконечно, но в противном случае должна быть > 0.

      Невозможно изменить cycleCount активной Animation. Если значение cycleCount изменяется для активной Animation, анимация должна быть остановлена и запущена снова, чтобы получить новое значение.

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

      1.0

      См. также:

      getCycleCount(), setCycleCount(int)

    • autoReverse

      public final BooleanProperty autoReverseProperty
      Определяет, будет ли эта Animation изменять направление на каждом цикле. Если true, Animation будет выполняться вперёд в первом цикле, а затем назад во втором цикле и так далее. В противном случае анимация будет повторяться так, что каждый цикл будет начинаться с начала. Невозможно изменить флаг autoReverse активной Animation. Если значение autoReverse изменяется для активной Animation, анимация должна быть остановлена и запущена снова, чтобы получить новое значение.

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

      false

      См. также:

      isAutoReverse(), setAutoReverse(boolean)

    • status

      public final ReadOnlyObjectProperty<Animation.Status> statusProperty
      Статус Animation. В Animation может находиться в одном из трёх состояний: Animation.Status.STOPPED, Animation.Status.PAUSED или Animation.Status.RUNNING.

      См. также:

      getStatus(), setStatus(Status)

    • onFinished

      public final ObjectProperty<EventHandler<ActionEvent>> onFinishedProperty
      Действие, которое должно быть выполнено по завершении этой Animation.

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

      null

      См. также:

      getOnFinished(), setOnFinished(EventHandler)

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

    • INDEFINITE

      public static final int INDEFINITE
      Используется для задания анимации, которая повторяется бесконечно, пока не будет вызван метод stop().

      См. также:

      Значения константных полей

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

    • Animation

      protected Animation(double targetFramerate)
      Конструктор Animation. Этот конструктор позволяет определить целевую частоту кадров.

      Параметры:

      targetFramerate — пользовательская целевая частота кадров для этой Animation

      См. также:

      getTargetFramerate()

    • Animation

      protected Animation()
      Конструктор Animation.
  • Подробности метода

    • setRate

      public final void setRate(double value)
      Задает значение свойства rate.

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

      Определяет направление/скорость, с которой предполагается воспроизведение Animation.

      Абсолютное значение rate указывает скорость, с которой следует воспроизводить Animation, в то время как знак rate указывает направление. Положительное значение rate указывает на воспроизведение вперед, отрицательное значение указывает на воспроизведение назад, а 0.0 — остановить запущенный Animation.

      Rate 1.0 - нормальное воспроизведение, 2.0 - в 2 раза быстрее обычного, -1.0 - в обратном направлении и т. д.

      Инвертирование скорости работающего Animation приведет к тому, что Animation изменит направление на месте и воспроизведет часть Animation, которая уже прошла.

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

      1.0

    • getRate

      public final double getRate()
      Получает значение свойства rate.

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

      Определяет направление/скорость, с которой предполагается воспроизведение Animation.

      Абсолютное значение rate указывает скорость, с которой следует воспроизводить Animation, в то время как знак rate указывает направление. Положительное значение rate указывает на воспроизведение вперед, отрицательное значение указывает на воспроизведение назад, а 0.0 — остановить запущенный Animation.

      Rate 1.0 - нормальное воспроизведение, 2.0 - в 2 раза быстрее обычного, -1.0 - в обратном направлении и т. д.

      Инвертирование скорости работающего Animation приведет к тому, что Animation изменит направление на месте и воспроизведет часть Animation, которая уже прошла.

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

      1.0

    • rateProperty

      public final DoubleProperty rateProperty()
      Определяет направление/скорость, с которой предполагается воспроизведение Animation.

      Абсолютное значение rate указывает скорость, с которой следует воспроизводить Animation, в то время как знак rate указывает направление. Положительное значение rate указывает на воспроизведение вперед, отрицательное значение указывает на воспроизведение назад, а 0.0 — остановить запущенный Animation.

      Rate 1.0 - нормальное воспроизведение, 2.0 - в 2 раза быстрее обычного, -1.0 - в обратном направлении и т. д.

      Инвертирование скорости работающего Animation приведет к тому, что Animation изменит направление на месте и воспроизведет часть Animation, которая уже прошла.

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

      1.0

      См. также:

      getRate(), setRate(double)

    • getCurrentRate

      public final double getCurrentRate()
      Получает значение свойства currentRate.

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

      Переменная только для чтения, указывающая текущее направление/скорость воспроизведения Animation.

      currentRate не обязательно равно rate. currentRate устанавливается в 0.0, когда анимация приостановлена ​​или остановлена. currentRate может также указывать на другое направление во время обратных циклов, когда autoReverse — true

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

      0.0

    • currentRateProperty

      public final ReadOnlyDoubleProperty currentRateProperty()
      Переменная только для чтения, указывающая текущее направление/скорость воспроизведения Animation.

      currentRate не обязательно равно rate. currentRate устанавливается в 0.0, когда анимация приостановлена ​​или остановлена. currentRate может также указывать на другое направление во время обратных циклов, когда autoReverse — true

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

      0.0

      См. также:

      getCurrentRate()

    • setCycleDuration

      protected final void setCycleDuration(Duration value)
      Задает значение свойства cycleDuration.

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

      Переменная только для чтения, указывающая продолжительность одного цикла этого Animation: время, необходимое для воспроизведения от времени 0 до конца Animation (при значении по умолчанию rate 1.0).

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

      0ms

    • getCycleDuration

      public final Duration getCycleDuration()
      Получает значение свойства cycleDuration.

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

      Переменная только для чтения, указывающая продолжительность одного цикла этого Animation: время, необходимое для воспроизведения от времени 0 до конца Animation (при значении по умолчанию rate 1.0).

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

      0ms

    • cycleDurationProperty

      public final ReadOnlyObjectProperty<Duration> cycleDurationProperty()
      Переменная только для чтения, указывающая продолжительность одного цикла этого Animation: время, необходимое для воспроизведения от времени 0 до конца Animation (при значении по умолчанию rate 1.0).

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

      0ms

      См. также:

      getCycleDuration(), setCycleDuration(Duration)

    • getTotalDuration

      public final Duration getTotalDuration()
      Получает значение свойства totalDuration.

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

      Переменная только для чтения, указывающая общую продолжительность этого Animation, включая повторы. Animation со значением cycleCount Animation.INDEFINITE будет иметь totalDuration Duration.INDEFINITE.

      Это значение равно cycleDuration * cycleCount.

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

      0ms

    • totalDurationProperty

      public final ReadOnlyObjectProperty<Duration> totalDurationProperty()
      Переменная только для чтения, указывающая общую продолжительность этого Animation, включая повторы. Animation со значением cycleCount Animation.INDEFINITE будет иметь totalDuration Duration.INDEFINITE.

      Это значение равно cycleDuration * cycleCount.

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

      0ms

      См. также:

      getTotalDuration()

    • getCurrentTime

      public final Duration getCurrentTime()
      Получает значение свойства currentTime.

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

      Определяет позицию головки воспроизведения Animation.

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

      0ms

    • currentTimeProperty

      public final ReadOnlyObjectProperty<Duration> currentTimeProperty()
      Определяет позицию головки воспроизведения Animation.

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

      0ms

      См. также:

      getCurrentTime()

    • setDelay

      public final void setDelay(Duration value)
      Задает значение свойства delay.

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

      Задерживает запуск анимации. Не может быть отрицательным. Установка отрицательного числа приведет к IllegalArgumentException.

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

      0ms

    • getDelay

      public final Duration getDelay()
      Получает значение свойства delay.

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

      Задерживает запуск анимации. Не может быть отрицательным. Установка отрицательного числа приведет к IllegalArgumentException.

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

      0ms

    • delayProperty

      public final ObjectProperty<Duration> delayProperty()
      Задерживает запуск анимации. Не может быть отрицательным. Установка отрицательного числа приведет к IllegalArgumentException.

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

      0ms

      См. также:

      getDelay(), setDelay(Duration)

    • setCycleCount

      public final void setCycleCount(int value)
      Задает значение свойства cycleCount.

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

      Определяет количество циклов в этой анимации. cycleCount может быть INDEFINITE для анимаций, которые повторяются бесконечно, но в противном случае должно быть > 0.

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

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

      1.0

    • getCycleCount

      public final int getCycleCount()
      Получает значение свойства cycleCount.

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

      Определяет количество циклов в этой анимации. cycleCount может быть INDEFINITE для анимаций, которые повторяются бесконечно, но в противном случае должно быть > 0.

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

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

      1.0

    • cycleCountProperty

      public final IntegerProperty cycleCountProperty()
      Определяет количество циклов в этом анимационном эффекте. Значение cycleCount может быть INDEFINITE для анимаций, которые повторяются бесконечно, но в противном случае должно быть > 0.

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

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

      1.0

      См. также:

      getCycleCount(), setCycleCount(int)

    • setAutoReverse

      public final void setAutoReverse(boolean value)
      Устанавливает значение свойства autoReverse.

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

      Определяет, будет ли этот Animation изменять направление на чередующихся циклах. Если true, Animation будет выполняться вперёд в первом цикле, затем изменит направление во втором цикле и так далее. В противном случае анимация будет циклично повторяться, так что каждый цикл выполняется вперёд с начала. Невозможно изменить флаг autoReverse работающего Animation. Если значение autoReverse изменено для работающего Animation, анимация должна быть остановлена и запущена снова, чтобы использовать новое значение.

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

      false

    • isAutoReverse

      public final boolean isAutoReverse()
      Получает значение свойства autoReverse.

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

      Определяет, будет ли этот Animation изменять направление на чередующихся циклах. Если true, Animation будет выполняться вперёд в первом цикле, затем изменит направление во втором цикле и так далее. В противном случае анимация будет циклично повторяться, так что каждый цикл выполняется вперёд с начала. Невозможно изменить флаг autoReverse работающего Animation. Если значение autoReverse изменено для работающего Animation, анимация должна быть остановлена и запущена снова, чтобы использовать новое значение.

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

      false

    • autoReverseProperty

      public final BooleanProperty autoReverseProperty()
      Определяет, будет ли этот Animation изменять направление на чередующихся циклах. Если true, Animation будет выполняться вперёд в первом цикле, затем изменит направление во втором цикле и так далее. В противном случае анимация будет циклично повторяться, так что каждый цикл выполняется вперёд с начала. Невозможно изменить флаг autoReverse работающего Animation. Если значение autoReverse изменено для работающего Animation, анимация должна быть остановлена и запущена снова, чтобы использовать новое значение.

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

      false

      См. также:

      isAutoReverse(), setAutoReverse(boolean)

    • setStatus

      protected final void setStatus(Animation.Status value)
      Устанавливает значение свойства status.

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

      Состояние Animation. В Animation может находиться в одном из трёх состояний: Animation.Status.STOPPED, Animation.Status.PAUSED или Animation.Status.RUNNING.

    • getStatus

      public final Animation.Status getStatus()
      Получает значение свойства status.

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

      Состояние Animation. В Animation может находиться в одном из трёх состояний: Animation.Status.STOPPED, Animation.Status.PAUSED или Animation.Status.RUNNING.

    • statusProperty

      public final ReadOnlyObjectProperty<Animation.Status> statusProperty()
      Состояние Animation. В Animation может находиться в одном из трёх состояний: Animation.Status.STOPPED, Animation.Status.PAUSED или Animation.Status.RUNNING.

      См. также:

      getStatus(), setStatus(Status)

    • getTargetFramerate

      public final double getTargetFramerate()
      Целевая частота кадров — это максимальная частота кадров, с которой будет выполняться этот Animation, в кадрах в секунду. Это можно использовать, например, чтобы предотвратить чрезмерное потребление системных ресурсов особенно сложными Animations. По умолчанию частота кадров Animation не ограничена явно, что означает, что Animation будет выполняться с оптимальной частотой кадров для платформы.

      Возвращает:

      целевую частоту кадров

    • setOnFinished

      public final void setOnFinished(EventHandler<ActionEvent> value)
      Устанавливает значение свойства onFinished.

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

      Действие, которое должно быть выполнено по завершении этого Animation.

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

      null

    • getOnFinished

      public final EventHandler<ActionEvent> getOnFinished()
      Получает значение свойства onFinished.

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

      Действие, которое должно быть выполнено по завершении этого Animation.

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

      null

    • onFinishedProperty

      public final ObjectProperty<EventHandler<ActionEvent>> onFinishedProperty()
      Действие, которое должно быть выполнено по завершении этого Animation.

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

      null

      См. также:

      getOnFinished(), setOnFinished(EventHandler)

    • getCuePoints

      public final ObservableMap<String,Duration> getCuePoints()
      Точки отсчёта могут использоваться для маркировки важных позиций в Animation. После определения точки отсчёта она может использоваться в качестве аргумента методов jumpTo() и playFrom() для быстрого перехода к соответствующей позиции.

      Каждый Animation имеет две предопределённые точки отсчёта "start" и "end", которые устанавливаются в начале и в конце Animation соответственно. Предопределённые точки отсчёта не отображаются в отображении, попытки их перезаписать не имеют эффекта.

      Другой способ определения точки отсчёта в Animation — установить свойство KeyFrame.name для KeyFrame.

      Возвращает:

      ObservableMap точек отсчёта

    • jumpTo

      public void jumpTo(Duration time)
      Переходит к заданной позиции в этом Animation. Если заданное время меньше Duration.ZERO, этот метод перейдёт к началу анимации. Если заданное время больше, чем продолжительность этого Animation, этот метод перейдёт к концу.

      Параметры:

      time - новая позиция

      Исключения:

      NullPointerException - если time находится в состоянии null

    • jumpTo

      public void jumpTo(String cuePoint)
      Переходит к предварительно определённой позиции в этом Animation. Этот метод ищет запись в точках отсчёта и переходит к соответствующей позиции, если её находит.

      Если точка отсчёта находится за концом этого Animation, вызов jumpTo приведёт к переходу к концу. Если у точки отсчёта отрицательная продолжительность Duration, это приведёт к переходу к началу. Если у точки отсчёта значение Duration.UNKNOWN, вызов jumpTo не повлияет на эту точку отсчёта.

      Существуют две предопределённые точки отсчёта "start" и "end", которые определены как начало и конец этого Animation соответственно.

      Параметры:

      cuePoint - имя точки отсчёта

      Исключения:

      NullPointerException - если cuePoint находится в состоянии null

      См. также:

      getCuePoints()

    • playFrom

      public void playFrom(String cuePoint)
      Удобный метод для воспроизведения этого Animation с предварительно определённой позиции. Позиция должна быть предварительно определена в точках отсчёта. Вызов этого метода эквивалентен
      animation.jumpTo(cuePoint);
       animation.play();
      . Обратите внимание, что в отличие от playFromStart() вызов этого метода не изменит направления воспроизведения этого Animation.

      Параметры:

      cuePoint - имя точки отсчёта

      Исключения:

      NullPointerException - если cuePoint находится в состоянии null

      См. также:

      getCuePoints()

    • playFrom

      public void playFrom(Duration time)
      Удобный метод для воспроизведения этого Animation с конкретной позиции. Вызов этого метода эквивалентен
      animation.jumpTo(time);
       animation.play();
      . Обратите внимание, что в отличие от playFromStart() вызов этого метода не изменит направления воспроизведения этого Animation.

      Параметры:

      time - позиция, с которой начать воспроизведение

      Исключения:

      NullPointerException - если time находится в состоянии null

    • воспроизведение

      public void play()
      Воспроизводит Animation с текущей позиции в указанном направлении rate. Если Animation выполняется, это не повлияет.

      При rate > 0 (прямое воспроизведение), если Animation уже находится в конце, первый цикл не будет воспроизведён, он считается завершённым. Это также относится к обратной ( rate < 0) перемотке, если Animation находится в начале. Однако, если у Animation есть cycleCount > 1, последующие циклы будут воспроизведены как обычно.

      Когда Animation достигает конца, Animation останавливается, а точка воспроизведения остаётся в конце.

      Чтобы воспроизвести Animation назад с конца:
      animation.setRate(negative rate);
      animation.jumpTo(overall duration of animation);
      animation.play();

      Примечание:

      • play() — асинхронный вызов, Animation может не начаться сразу.

      Исключения:

      IllegalStateException — если встроено в другую анимацию, например, SequentialTransition или ParallelTransition

    • playFromStart

      public void playFromStart()
      Воспроизводит Animation с начальной позиции в прямом направлении.

      Это эквивалентно

      animation.stop();
      animation.setRate = setRate(Math.abs(animation.getRate())); animation.jumpTo(Duration.ZERO);
      animation.play();

      Примечание:

      • playFromStart() — асинхронный вызов, Animation может не начаться сразу.

      Исключения:

      IllegalStateException — если встроено в другую анимацию, например, SequentialTransition или ParallelTransition

    • остановка

      public void stop()
      Останавливает анимацию и сбрасывает точку воспроизведения в исходное положение. Если анимация в данный момент не выполняется, этот метод не окажет никакого эффекта.

      Примечание:

      • stop() — асинхронный вызов, Animation может не остановиться сразу.

      Исключения:

      IllegalStateException — если встроено в другую анимацию, например, SequentialTransition или ParallelTransition

    • пауза

      public void pause()
      Приостанавливает анимацию. Если анимация в данный момент не выполняется, этот метод не окажет никакого эффекта.

      Примечание:

      • pause() — асинхронный вызов, Animation может не приостановиться сразу.

      Исключения:

      IllegalStateException — если встроено в другую анимацию, например, SequentialTransition или ParallelTransition

© 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