Класс ActionEvent

public class ActionEvent
extends AWTEvent

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

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

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

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

Поля

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)

Параметры:

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

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

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

Исключения:

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

См. также:

EventObject.getSource(), AWTEvent.getID(), getActionCommand()

ActionEvent

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

Параметры:

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)

Параметры:

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()

Возвращает:

строку, идентифицирующую команду для данного события

getWhen

public long getWhen()

Возвращает метку времени, когда произошло это событие. Поскольку ActionEvent является высокоуровневым семантическим событием, метка времени обычно совпадает с меткой времени базового InputEvent.

Возвращает:

метка времени этого события

С:

1.4

getModifiers

public int getModifiers()

Возвращает модификаторы клавиш, удерживаемые во время события действия.

Возвращает:

побитовое или констант модификаторов

paramString

public String paramString()

Возвращает строку параметров, идентифицирующую это событие действия. Этот метод полезен для ведения журнала событий и для отладки.

Переопределяет:

paramString в классе AWTEvent

Возвращает:

строку, идентифицирующую событие и связанную с ним команду