javax.swing

Таймер класса

java.lang. Объект

javax.swing. Таймер

Все Реализованные Интерфейсы:

Сериализуемый

public class Timer
extends Object
implements Serializable

Огни один или больше ActionEvents в указанных интервалах. Использование в качестве примера является объектом анимации, который использует a Timer как триггер для рисования его фреймов.

Установка таймера включает создание a Timer объект, регистрируя одного или более слушателей действия на этом, и запуская таймер, используя start метод. Например, следующий код создает и запускает таймер, который запускает событие действия однажды в секунду (как определено первым параметром Timer конструктор). Второй параметр Timer конструктор определяет слушателя, чтобы получить события действия таймера.

  int delay = 1000; //milliseconds
  ActionListener taskPerformer = new ActionListener() {
      public void actionPerformed(ActionEvent evt) {
          //...Perform a task...
      }
  };
  new Timer(delay, taskPerformer).start();

Timers создаются, определяя и параметр задержки и ActionListener. Параметр задержки используется, чтобы установить и начальную задержку и задержку между увольнением события в миллисекундах. Как только таймер был запущен, он ожидает начальной задержки прежде, чем запустить его первое ActionEvent зарегистрированным слушателям. После этого первого события это продолжает запускать события каждый раз, когда задержка между событиями протекла, пока это не останавливается.

После конструкции начальная задержка и задержка между событиями могут быть изменены независимо, и дополнительные ActionListeners может быть добавлен.

Если Вы хотите, чтобы таймер стрелял только в первый раз и затем остановился, вызвать setRepeats(false) на таймере.

Хотя все Timers выполняют свое ожидающее использование единственного, совместно используемого потока (создаваемый первым Timer объект, который выполняется), обработчики событий действия для Timers выполняются на другом потоке - диспетчеризирующий событие поток. Это означает что обработчики действия для Timers может безопасно выполнить операции на компонентах Swing. Однако, это также означает, что обработчики должны выполниться быстро, чтобы сохранить GUI быстро реагирующим.

В v 1.3, другом Timer класс был добавлен к платформе Java: java.util.Timer. И это и javax.swing.Timer обеспечьте ту же самую основную функциональность, но java.util.Timer является более общим и имеет больше функций. javax.swing.Timer имеет две функции, которые могут сделать немного легче использовать с GUI. Во-первых, его метафора обработки событий знакома программистам GUI и может сделать контакт с диспетчеризирующим событие потоком немного более простым. Во-вторых, его автоматическое совместное использование потока означает, что Вы не должны сделать специальные шаги, чтобы избежать порождать слишком много потоков. Вместо этого Ваш таймер использует тот же самый поток, используемый, чтобы заставить курсоры мигнуть, подсказки появляются и так далее.

Можно найти дальнейшую документацию и несколько примеров использования таймеров, посещая, Как Использовать Таймеры, раздел в Учебном руководстве по Java. Для большего количества примеров и справки в выборе между этим Timer класс и java.util.Timer, см. Используя Таймеры в Приложениях Swing, статью в Соединении Swing.

Предупреждение: Сериализированные объекты этого класса не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

См. Также:

java.util.Timer

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected EventListenerList	listenerList

Сводка конструктора

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

Конструктор и Описание
Timer(int delay, ActionListener listener) Создает a Timer и инициализирует и начальную задержку и задержку между событиями к delay миллисекунды.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	addActionListener(ActionListener listener) Добавляет слушатель действия Timer.
protected void	fireActionPerformed(ActionEvent e) Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
Строка	getActionCommand() Возвращает строку, которая будет поставлена как команда действия в ActionEvents запущенный этим таймером.
ActionListener[]	getActionListeners() Возвращает массив всех слушателей действия, зарегистрированных на этом таймере.
int	getDelay() Возвращает задержку, в миллисекундах, между взрывами событий действия.
int	getInitialDelay() Возвраты Timer's начальная задержка.
<T extends EventListener> T[]	getListeners(Class<T> listenerType) Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на это Timer.
static boolean	getLogTimers() Возвраты true если журналирование включается.
boolean	isCoalesce() Возвраты true если Timer объединяет многократные события действия на ожидании.
boolean	isRepeats() Возвраты true (значение по умолчанию), если Timer отправит событие действия его слушателям многократно.
boolean	isRunning() Возвраты true если Timer работает.
void	removeActionListener(ActionListener listener) Удаляет указанного слушателя действия из Timer.
void	restart() Перезапуски Timer, отмена любых взрывов на ожидании и то, чтобы заставлять это стрелять с его начальной задержкой.
void	setActionCommand(String command) Устанавливает строку, которая будет поставлена как команда действия в ActionEvents запущенный этим таймером.
void	setCoalesce(boolean flag) Наборы, ли Timer объединяет многократное ожидание ActionEvent взрывы.
void	setDelay(int delay) Наборы Timer's между событиями задерживаются, число миллисекунд между последовательными событиями действия.
void	setInitialDelay(int initialDelay) Наборы Timer's начальная задержка, время в миллисекундах, чтобы ожидать после того, как таймер запускается прежде, чем запустить первое событие.
static void	setLogTimers(boolean flag) Включения или отключения журнал таймера.
void	setRepeats(boolean flag) Если flag false, сообщает Timer отправить только одно событие действия его слушателям.
void	start() Запускается Timer, то, чтобы заставлять это начать отправлять события действия его слушателям.
void	stop() Остановки Timer, то, чтобы заставлять это прекратить отправлять события действия его слушателям.

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

listenerList

protected EventListenerList listenerList

Деталь конструктора

Таймер

public Timer(int delay,
     ActionListener listener)

Создает a Timer и инициализирует и начальную задержку и задержку между событиями к delay миллисекунды. Если delay меньше чем или равно нулю, огни таймера, как только он запускается. Если listener не null, это регистрируется как слушатель действия на таймере.

Параметры:

delay - миллисекунды для начальной и задержки между событиями

listener - начальный слушатель; может быть null

См. Также:

addActionListener(java.awt.event.ActionListener), setInitialDelay(int), setRepeats(boolean)

Деталь метода

addActionListener

public void addActionListener(ActionListener listener)

Добавляет слушатель действия Timer.

Параметры:

listener - слушатель, чтобы добавить

См. Также:

Timer(int, java.awt.event.ActionListener)

removeActionListener

public void removeActionListener(ActionListener listener)

Удаляет указанного слушателя действия из Timer.

Параметры:

listener - слушатель, чтобы удалить

getActionListeners

public ActionListener[] getActionListeners()

Возвращает массив всех слушателей действия, зарегистрированных на этом таймере.

Возвраты:

весь таймер ActionListeners или пустой массив, если никакие слушатели действия в настоящий момент не регистрируются

С тех пор:

1.4

См. Также:

addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener)

fireActionPerformed

protected void fireActionPerformed(ActionEvent e)

Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.

Параметры:

e - событие действия, чтобы стрелять

См. Также:

EventListenerList

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на это Timer. FooListeners регистрируются, используя addFooListener метод.

Можно определить listenerType параметр с литералом класса, такой как FooListener.class. Например, можно запросить a Timer экземпляр t для его слушателей действия со следующим кодом:

ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));

Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.

Параметры:

listenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener

Возвраты:

массив всех объектов, зарегистрированных как FooListeners на этом таймере, или пустом массиве, если никакие такие слушатели не были добавлены

Броски:

ClassCastException - если listenerType не определяет класс или интерфейс, который реализует java.util.EventListener

С тех пор:

1.3

См. Также:

getActionListeners(), addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener)

setLogTimers

public static void setLogTimers(boolean flag)

Включения или отключения журнал таймера. Когда включено, объявление повешено к System.out всякий раз, когда таймер уходит.

Параметры:

flag - true позволять регистрировать

См. Также:

getLogTimers()

getLogTimers

public static boolean getLogTimers()

Возвраты true если журналирование включается.

Возвраты:

true если журналирование включается; иначе, ложь

См. Также:

setLogTimers(boolean)

setDelay

public void setDelay(int delay)

Наборы Timer's между событиями задерживаются, число миллисекунд между последовательными событиями действия. Это не влияет на начальное свойство задержки, которое может быть установлено setInitialDelay метод.

Параметры:

delay - задержка миллисекунд

См. Также:

setInitialDelay(int)

getDelay

public int getDelay()

Возвращает задержку, в миллисекундах, между взрывами событий действия.

См. Также:

setDelay(int), getInitialDelay()

setInitialDelay

public void setInitialDelay(int initialDelay)

Наборы Timer's начальная задержка, время в миллисекундах, чтобы ожидать после того, как таймер запускается прежде, чем запустить первое событие. На конструкцию это устанавливается быть тем же самым как задержкой между событиями, но тогда ее значение независимо и остается незатронутым изменениями к задержке между событиями.

Параметры:

initialDelay - начальная задержка, в миллисекундах

См. Также:

setDelay(int)

getInitialDelay

public int getInitialDelay()

Возвраты Timer's начальная задержка.

См. Также:

setInitialDelay(int), setDelay(int)

setRepeats

public void setRepeats(boolean flag)

Если flag false, сообщает Timer отправить только одно событие действия его слушателям.

Параметры:

flag - определить false заставить таймер остановиться после отправки его первого события действия

isRepeats

public boolean isRepeats()

Возвраты true (значение по умолчанию), если Timer отправит событие действия его слушателям многократно.

См. Также:

setRepeats(boolean)

setCoalesce

public void setCoalesce(boolean flag)

Наборы, ли Timer объединяет многократное ожидание ActionEvent взрывы. Занятое приложение, возможно, не в состоянии не отставать от a Timer's генерация события, заставляя многократные события действия быть поставленным в очередь. Когда обработано, приложение отправляет эти события один за другим, вызывая Timer's слушатели, чтобы получить последовательность событий без задержки между ними. Объединение избегает этой ситуации, уменьшая многократные события на ожидании до единственного события. Timers объединяют события по умолчанию.

Параметры:

flag - определить false выключить объединение

isCoalesce

public boolean isCoalesce()

Возвраты true если Timer объединяет многократные события действия на ожидании.

См. Также:

setCoalesce(boolean)

setActionCommand

public void setActionCommand(String command)

Устанавливает строку, которая будет поставлена как команда действия в ActionEvents запущенный этим таймером. null приемлемое значение.

Параметры:

command - команда действия

С тех пор:

1.6

getActionCommand

public String getActionCommand()

Возвращает строку, которая будет поставлена как команда действия в ActionEvents запущенный этим таймером. Может быть null, который является также значением по умолчанию.

Возвраты:

команда действия используется в увольнении событий

С тех пор:

1.6

запустить

public void start()

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

См. Также:

stop()

isRunning

public boolean isRunning()

Возвраты true если Timer работает.

См. Также:

start()

остановиться

public void stop()

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

См. Также:

start()

перезапуск

public void restart()

Перезапуски Timer, отмена любых взрывов на ожидании и то, чтобы заставлять это стрелять с его начальной задержкой.