Spec-Zone.ru › OpenJDK 27

Класс ActionEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.ActionEvent
Все реализуемые интерфейсы:
Serializable
public class ActionEvent extends AWTEvent
Семантическое событие, указывающее на выполнение действия, определённого компонентом. Это высокоуровневое событие генерируется компонентом (например, Button), когда происходит действие, специфичное для этого компонента (например, нажатие). Событие передаётся каждому объекту ActionListener, зарегистрированному для получения таких событий с помощью метода addActionListener компонента.

Примечание: Чтобы вызвать ActionEvent на Button с помощью клавиатуры, используйте клавишу пробела.

Объект, реализующий интерфейс ActionListener, получает это ActionEvent при возникновении события. Таким образом, слушателю не нужно обрабатывать отдельные движения и щелчки мыши; вместо этого он может обрабатывать «значимое» (семантическое) событие, например «кнопка нажата».

Если параметр id какого-либо экземпляра ActionEvent не находится в диапазоне от ACTION_FIRST до ACTION_LAST, поведение не определено.

С версии:
1.1
См. также:
  • ActionListener
  • Руководство: как написать слушатель действий
  • Сериализованная форма

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

Модификатор и тип Поле Описание
static final int ACTION_FIRST
Первый номер в диапазоне идентификаторов, используемых для событий действий.
static final int ACTION_LAST
Последний номер в диапазоне идентификаторов, используемых для событий действий.
static final int ACTION_PERFORMED
Этот идентификатор события указывает на то, что произошло значимое действие.
static final int ALT_MASK
Модификатор alt.
static final int CTRL_MASK
Модификатор control.
static final int META_MASK
Модификатор meta.
static final int SHIFT_MASK
Модификатор shift.

Поля, объявленные в классе AWTEvent

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK
Модификатор и тип Поле Описание
static final long ACTION_EVENT_MASK
Маска событий для выбора событий действий.
static final long ADJUSTMENT_EVENT_MASK
Маска событий для выбора событий изменения.
static final long COMPONENT_EVENT_MASK
Маска событий для выбора событий компонентов.
protected boolean consumed
Управляет тем, будет ли событие отправлено обратно пиру после его обработки источником: значение false означает, что оно будет отправлено пиру; значение true — что не будет.
static final long CONTAINER_EVENT_MASK
Маска событий для выбора событий контейнера.
static final long FOCUS_EVENT_MASK
Маска событий для выбора событий фокуса.
static final long HIERARCHY_BOUNDS_EVENT_MASK
Маска событий для выбора событий границ иерархии.
static final long HIERARCHY_EVENT_MASK
Маска событий для выбора событий иерархии.
protected int id
Идентификатор события.
static final long INPUT_METHOD_EVENT_MASK
Маска событий для выбора событий метода ввода.
static final long INVOCATION_EVENT_MASK
Маска событий для выбора событий вызова.
static final long ITEM_EVENT_MASK
Маска событий для выбора событий элементов.
static final long KEY_EVENT_MASK
Маска событий для выбора событий клавиатуры.
static final long MOUSE_EVENT_MASK
Маска событий для выбора событий мыши.
static final long MOUSE_MOTION_EVENT_MASK
Маска событий для выбора событий движения мыши.
static final long MOUSE_WHEEL_EVENT_MASK
Маска событий для выбора событий колеса мыши.
static final long PAINT_EVENT_MASK
Маска событий для выбора событий отрисовки.
static final int RESERVED_ID_MAX
Максимальное значение зарезервированных идентификаторов событий AWT.
static final long TEXT_EVENT_MASK
Маска событий для выбора текстовых событий.
static final long WINDOW_EVENT_MASK
Маска событий для выбора событий окна.
static final long WINDOW_FOCUS_EVENT_MASK
Маска событий для выбора событий фокуса окна.
static final long WINDOW_STATE_EVENT_MASK
Маска событий для выбора событий состояния окна.

Поля, объявленные в классе EventObject

source
Модификатор и тип Поле Описание
protected Object source
Объект, на котором первоначально произошло событие.

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

Конструктор Описание
ActionEvent(Object source, int id, String command)
Создаёт объект ActionEvent.
ActionEvent(Object source, int id, String command, int modifiers)
Создаёт объект ActionEvent с клавишами-модификаторами.
ActionEvent(Object source, int id, String command, long when, int modifiers)
Создаёт объект ActionEvent с указанными клавишами-модификаторами и временной меткой.

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

Модификатор и тип Метод Описание
String getActionCommand()
Возвращает строку команды, связанную с этим действием.
int getModifiers()
Возвращает клавиши-модификаторы, нажатые во время этого события действия.
long getWhen()
Возвращает временную метку возникновения этого события.
String paramString()
Возвращает строку параметров, идентифицирующую это событие действия.

Методы, объявленные в классе AWTEvent

consume, getID, isConsumed, setSource, toString
Модификатор и тип Метод Описание
protected void consume()
Поглощает это событие, если его можно поглотить.
int getID()
Возвращает тип события.
protected boolean isConsumed()
Возвращает информацию о том, было ли поглощено это событие.
void setSource(Object newSource)
Перенаправляет событие к новому источнику.
String toString()
Возвращает строковое представление этого объекта.

Методы, объявленные в классе EventObject

getSource
Модификатор и тип Метод Описание
Object getSource()
Объект, на котором первоначально произошло событие.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создаёт и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли этот объект какому-либо другому.
protected void finalize()
Устарело и будет удалено: этот элемент API может быть удалён в будущей версии.
Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определённого времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определённого времени.

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

SHIFT_MASK

public static final int SHIFT_MASK
Модификатор shift. Указывает, что во время события была нажата клавиша shift.
См. также:
  • Значения констант полей

CTRL_MASK

public static final int CTRL_MASK
Модификатор control. Указывает, что во время события была нажата клавиша control.
См. также:
  • Значения констант полей

META_MASK

public static final int META_MASK
Модификатор meta. Указывает, что во время события была нажата клавиша meta.
См. также:
  • Значения констант полей

ALT_MASK

public static final int ALT_MASK
Модификатор alt. Указывает, что во время события была нажата клавиша alt.
См. также:
  • Значения констант полей

ACTION_FIRST

public static final int ACTION_FIRST
Первый номер в диапазоне идентификаторов, используемых для событий действий.
См. также:
  • Значения констант полей

ACTION_LAST

public static final int ACTION_LAST
Последний номер в диапазоне идентификаторов, используемых для событий действий.
См. также:
  • Значения констант полей

ACTION_PERFORMED

@Native public static final int ACTION_PERFORMED
Этот идентификатор события указывает на то, что произошло значимое действие.
См. также:
  • Значения констант полей

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

ActionEvent

public ActionEvent(Object source, int id, String command)
Создаёт объект ActionEvent.

Этот метод вызывает исключение IllegalArgumentException, если source имеет значение null. Строка null command допустима, но не рекомендуется.

Параметры:
source — объект, вызвавший событие
id — целое число, идентифицирующее событие. Допустимые значения см. в описании класса ActionEvent
command — строка, которая может задавать команду (возможно, одну из нескольких), связанную с событием
Выбрасывает:
IllegalArgumentException — если source имеет значение null
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • getActionCommand()

ActionEvent

public ActionEvent(Object source, int id, String command, int modifiers)
Создаёт объект ActionEvent с клавишами-модификаторами.

Этот метод вызывает исключение IllegalArgumentException, если source имеет значение null. Строка null command допустима, но не рекомендуется.

Параметры:
source — объект, вызвавший событие
id — целое число, идентифицирующее событие. Допустимые значения см. в описании класса ActionEvent
command — строка, которая может задавать команду (возможно, одну из нескольких), связанную с событием
modifiers — клавиши-модификаторы, нажатые во время события (shift, ctrl, alt, meta). Передавать отрицательное значение не рекомендуется. Нулевое значение означает, что модификаторы не передавались
Выбрасывает:
IllegalArgumentException — если source имеет значение null
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • getActionCommand()
  • getModifiers()

ActionEvent

public ActionEvent(Object source, int id, String command, long when, int modifiers)
Создаёт объект ActionEvent с указанными клавишами-модификаторами и временной меткой.

Этот метод вызывает исключение IllegalArgumentException, если source имеет значение null. Строка null command допустима, но не рекомендуется.

Параметры:
source — объект, вызвавший событие
id — целое число, идентифицирующее событие. Допустимые значения см. в описании класса ActionEvent
command — строка, которая может задавать команду (возможно, одну из нескольких), связанную с событием
when — значение типа long, задающее время возникновения события. Передавать отрицательное или нулевое значение не рекомендуется
modifiers — клавиши-модификаторы, нажатые во время события (shift, ctrl, alt, meta). Передавать отрицательное значение не рекомендуется. Нулевое значение означает, что модификаторы не передавались
Выбрасывает:
IllegalArgumentException — если source имеет значение null
С версии:
1.4
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • getActionCommand()
  • getModifiers()
  • getWhen()

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

getActionCommand

public String getActionCommand()
Возвращает строку команды, связанную с этим действием. Эта строка позволяет «модальному» компоненту задавать одну из нескольких команд в зависимости от его состояния. Например, одна и та же кнопка может переключаться между командами «показать сведения» и «скрыть сведения». В обоих случаях исходный объект и событие будут одинаковыми, а строка команды будет указывать предполагаемое действие.

Обратите внимание: если при создании этого ActionEvent в конструктор была передана строка команды null, этот метод возвращает null.

Возвращает:
строку, идентифицирующую команду для этого события

getWhen

public long getWhen()
Возвращает временную метку возникновения этого события. Поскольку ActionEvent — высокоуровневое семантическое событие, его временная метка обычно совпадает с временной меткой базового InputEvent.
Возвращает:
временную метку этого события
С версии:
1.4

getModifiers

public int getModifiers()
Возвращает клавиши-модификаторы, нажатые во время этого события действия.
Возвращает:
побитовое ИЛИ констант модификаторов

paramString

public String paramString()
Возвращает строку параметров, идентифицирующую это событие действия. Этот метод полезен для ведения журнала событий и отладки.
Переопределяет:
paramString в классе AWTEvent
Возвращает:
строку, идентифицирующую событие и связанную с ним команду

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2026, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API