Spec-Zone.ru › OpenJDK 17

Класс 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
  • Tutorial: How to Write an Action Listener
  • Serialized Form

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

Модификатор и тип Поле Описание
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. Указывает, что клавиша 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 - Строка, которая может указывать команду (возможно, одну из нескольких), связанную с событием
modifiers - Модификаторы клавиш, нажатые во время события (Shift, Ctrl, Alt, Meta). Передача отрицательного параметра не рекомендуется. Ноль означает, что модификаторы не были заданы
when - Длинное целое число, представляющее время наступления события. Передача отрицательного или нулевого значения не рекомендуется
Исключения:
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, 2021, 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/17/docs/api/java.desktop/java/awt/event/ActionEvent.html

Spec-Zone.ru

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