Spec-Zone.ru › OpenJDK 24

Класс 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
  • Учебник: Как написать обработчик событий Action Listener
  • Сериализованная форма

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

Модификатор и тип Поле Описание
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
Модификатор управления. Указатель, что клавиша 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 - Строка, которая может указывать команду (возможно, одну из нескольких), связанную с событием
when - Число с плавающей точкой, показывающее время наступления события. Передача отрицательного или нулевого значения не рекомендуется
modifiers - Модификаторы клавиш, нажатые во время события (Shift, Ctrl, Alt, Meta). Передача отрицательного параметра не рекомендуется. Ноль означает отсутствие нажатых модификаторов
Исключения:
IllegalArgumentException - если source равно null
С момента:
1.4
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • getActionCommand()
  • getModifiers()
  • getWhen()

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

getActionCommand

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

Обратите внимание, что если строка команды null была передана в конструктор для этого ActionEvent, этот метод возвращает 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/event/ActionEvent.html

Spec-Zone.ru

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