Класс ActionEvent

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

См. также:

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

Модификатор и тип	Поле	Описание
`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`	Модификатор Ctrl.
`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

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

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

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

getSource

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

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

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

SHIFT_MASK

public static final int SHIFT_MASK

Модификатор Shift. Указывает, что во время события была нажата клавиша Shift.

См. также:

CTRL_MASK

public static final int CTRL_MASK

Модификатор Ctrl. Указывает, что во время события была нажата клавиша Ctrl.

См. также:

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

См. также:

ActionEvent

public ActionEvent(Object source, int id, String command, int modifiers)

Создаёт объект ActionEvent с клавишами-модификаторами.

Параметры:

source — объект, вызвавший событие

id — целое число, идентифицирующее событие. Сведения о допустимых значениях см. в описании класса ActionEvent

command — строка, которая может задавать команду (возможно, одну из нескольких), связанную с событием

modifiers — клавиши-модификаторы, нажатые во время события (shift, ctrl, alt, meta). Передавать отрицательное значение не рекомендуется. Нулевое значение означает, что модификаторы не передавались

Исключения:

IllegalArgumentException — если source равен null

См. также:

ActionEvent

public ActionEvent(Object source, int id, String command, long when, int modifiers)

Создаёт объект ActionEvent с указанными клавишами-модификаторами и временной меткой.

Параметры:

source — объект, вызвавший событие

id — целое число, идентифицирующее событие. Сведения о допустимых значениях см. в описании класса ActionEvent

command — строка, которая может задавать команду (возможно, одну из нескольких), связанную с событием

when — long, задающий время возникновения события. Передавать отрицательное или нулевое значение не рекомендуется

Исключения:

IllegalArgumentException — если source равен null

Начиная с:

1.4

См. также:

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

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
Возвращает:: строку, идентифицирующую событие и связанную с ним команду

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/event/ActionEvent.html