Класс 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`	Модификатор Control.
`static final int`	`META_MASK`	Модификатор Meta.
`static final int`	`SHIFT_MASK`	Модификатор Shift.

Поля, объявленные в классе java.awt.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

Поля, объявленные в классе java.util.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()`	Возвращает строку параметра, идентифицирующую это событие действия.

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

consume, getID, isConsumed, setSource, toString

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

getSource

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

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

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

SHIFT_MASK

public static final int SHIFT_MASK

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

См. также:

CTRL_MASK

public static final int CTRL_MASK

Модификатор управления. Указывает, что клавиша 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

См. также:

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

См. также:

ActionEvent

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

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

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

Параметры:

source - Объект, породивший событие

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

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

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

Исключения:

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, 2023, 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/21/docs/api/java.desktop/java/awt/event/ActionEvent.html