Класс ActionEvent

Все реализованные интерфейсы:
Serializable
public class ActionEvent
extends AWTEvent

Семантическое событие, указывающее на то, что произошло действие, определённое компонентом. Это событие высокого уровня генерируется компонентом (например, Button) при возникновении специфичного для компонента действия (например, нажатия). Событие передаётся каждому объекту ActionListener, который зарегистрирован для получения таких событий с помощью метода addActionListener компонента.

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

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

Неопределённое поведение будет вызвано, если параметр id любого экземпляра ActionEvent не находится в диапазоне от ACTION_FIRST до ACTION_LAST.

С тех пор:
1.1
См. также:
ActionListener, Учебник: Как написать обработчик действий, Сериализованная форма

Поля

Модификатор и тип Поле Описание
static int ACTION_FIRST

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

Последнее число в диапазоне идентификаторов, используемых для событий действия.
static int ACTION_PERFORMED

Этот идентификатор события указывает на то, что произошло значимое действие.
static int ALT_MASK

Модификатор Alt.
static int CTRL_MASK

Модификатор Ctrl.
static int META_MASK

Модификатор Meta.
static 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

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

См. также:
Значения константных полей

META_MASK

public static final int META_MASK

Модификатор мета. Указатель, что клавиша 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 - Строка, которая может указать команду (возможно, одну из нескольких), связанную с событием
modifiers - Модификаторы клавиш, нажатые во время события (Shift, Ctrl, Alt, Meta). Передача отрицательного параметра не рекомендуется. Ноль означает, что модификаторы не были переданы.
when - Время, когда произошло событие. Передача отрицательного или нулевого значения не рекомендуется.
Исключения:
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
Возвращает:
строка, идентифицирующая событие и связанную с ним команду

© 1993, 2020, 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/11/docs/api/java.desktop/java/awt/event/ActionEvent.html

Spec-Zone .ru
спецификации, руководства, описания, API