Spec-Zone.ru › OpenJDK 27

Класс WindowEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.ComponentEvent
java.awt.event.WindowEvent
Все реализованные интерфейсы:
Serializable
public class WindowEvent extends ComponentEvent
Низкоуровневое событие, указывающее на изменение состояния окна. Это низкоуровневое событие генерируется объектом Window при его открытии, закрытии, активации, деактивации, сворачивании или восстановлении, а также при передаче фокуса окну или с него.

Событие передается каждому объекту WindowListener или WindowAdapter, зарегистрированному для получения таких событий с помощью метода addWindowListener окна. (Объекты WindowAdapter реализуют интерфейс WindowListener.) Каждый такой объект-обработчик получает этот WindowEvent при возникновении события.

Если параметр id какого-либо экземпляра WindowEvent не находится в диапазоне от WINDOW_FIRST до WINDOW_LAST, поведение не определено.

С версии:
1.1
См. также:
  • WindowAdapter
  • WindowListener
  • Учебное руководство: написание обработчика событий окна
  • Сериализованная форма

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

Модификатор и тип Поле Описание
static final int WINDOW_ACTIVATED
Тип события активации окна.
static final int WINDOW_CLOSED
Событие закрытия окна.
static final int WINDOW_CLOSING
Событие «окно закрывается».
static final int WINDOW_DEACTIVATED
Тип события деактивации окна.
static final int WINDOW_DEICONIFIED
Тип события восстановления окна.
static final int WINDOW_FIRST
Первый номер диапазона идентификаторов, используемых для событий окна.
static final int WINDOW_GAINED_FOCUS
Тип события получения фокуса окном.
static final int WINDOW_ICONIFIED
Событие сворачивания окна.
static final int WINDOW_LAST
Последний номер диапазона идентификаторов, используемых для событий окна.
static final int WINDOW_LOST_FOCUS
Тип события потери фокуса окном.
static final int WINDOW_OPENED
Событие открытия окна.
static final int WINDOW_STATE_CHANGED
Тип события изменения состояния окна.

Поля, объявленные в классе ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN
Модификатор и тип Поле Описание
static final int COMPONENT_FIRST
Первый номер диапазона идентификаторов, используемых для событий компонента.
static final int COMPONENT_HIDDEN
Это событие указывает, что компонент стал невидимым.
static final int COMPONENT_LAST
Последний номер диапазона идентификаторов, используемых для событий компонента.
static final int COMPONENT_MOVED
Это событие указывает, что положение компонента изменилось.
static final int COMPONENT_RESIZED
Это событие указывает, что размер компонента изменился.
static final int COMPONENT_SHOWN
Это событие указывает, что компонент стал видимым.

Поля, объявленные в классе 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
Модификатор и тип Поле Описание
static final long ACTION_EVENT_MASK
Маска событий для выбора событий действий.
static final long ADJUSTMENT_EVENT_MASK
Маска событий для выбора событий изменения.
static final long COMPONENT_EVENT_MASK
Маска событий для выбора событий компонентов.
protected boolean consumed
Определяет, отправляется ли событие обратно получателю после его обработки источником: значение false означает, что событие отправляется получателю; true — что оно не отправляется.
static final long CONTAINER_EVENT_MASK
Маска событий для выбора событий контейнеров.
static final long FOCUS_EVENT_MASK
Маска событий для выбора событий фокуса.
static final long HIERARCHY_BOUNDS_EVENT_MASK
Маска событий для выбора событий границ иерархии.
static final long HIERARCHY_EVENT_MASK
Маска событий для выбора событий иерархии.
protected int id
Идентификатор события.
static final long INPUT_METHOD_EVENT_MASK
Маска событий для выбора событий методов ввода.
static final long INVOCATION_EVENT_MASK
Маска событий для выбора событий вызова.
static final long ITEM_EVENT_MASK
Маска событий для выбора событий элементов.
static final long KEY_EVENT_MASK
Маска событий для выбора событий клавиатуры.
static final long MOUSE_EVENT_MASK
Маска событий для выбора событий мыши.
static final long MOUSE_MOTION_EVENT_MASK
Маска событий для выбора событий перемещения мыши.
static final long MOUSE_WHEEL_EVENT_MASK
Маска событий для выбора событий колеса мыши.
static final long PAINT_EVENT_MASK
Маска событий для выбора событий отрисовки.
static final int RESERVED_ID_MAX
Максимальное значение зарезервированных идентификаторов событий AWT.
static final long TEXT_EVENT_MASK
Маска событий для выбора текстовых событий.
static final long WINDOW_EVENT_MASK
Маска событий для выбора событий окна.
static final long WINDOW_FOCUS_EVENT_MASK
Маска событий для выбора событий фокуса окна.
static final long WINDOW_STATE_EVENT_MASK
Маска событий для выбора событий состояния окна.

Поля, объявленные в классе EventObject

source
Модификатор и тип Поле Описание
protected Object source
Объект, в котором изначально произошло событие.

Краткое описание конструкторов

Конструктор Описание
WindowEvent(Window source, int id)
Создает объект WindowEvent.
WindowEvent(Window source, int id, int oldState, int newState)
Создает объект WindowEvent с указанными предыдущим и новым состояниями окна.
WindowEvent(Window source, int id, Window opposite)
Создает объект WindowEvent с указанным противоположным Window.
WindowEvent(Window source, int id, Window opposite, int oldState, int newState)
Создает объект WindowEvent.

Краткое описание методов

Модификатор и тип Метод Описание
int getNewState()
Для событий WINDOW_STATE_CHANGED возвращает новое состояние окна.
int getOldState()
Для событий WINDOW_STATE_CHANGED возвращает предыдущее состояние окна.
Window getOppositeWindow()
Возвращает другое окно, участвующее в изменении фокуса или активации.
Window getWindow()
Возвращает источник события.
String paramString()
Возвращает строку параметров, описывающую это событие.

Методы, объявленные в классе ComponentEvent

getComponent
Модификатор и тип Метод Описание
Component getComponent()
Возвращает источник события.

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

consume, getID, isConsumed, setSource, toString
Модификатор и тип Метод Описание
protected void consume()
Потребляет это событие, если его можно потребить.
int getID()
Возвращает тип события.
protected boolean isConsumed()
Возвращает, было ли это событие потреблено.
void setSource(Object newSource)
Назначает событию новый источник.
String toString()
Возвращает строковое представление этого объекта.

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

getSource
Модификатор и тип Метод Описание
Object getSource()
Объект, в котором изначально произошло событие.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли какой-либо другой объект этому объекту.
protected void finalize()
Устарело и будет удалено: этот элемент API может быть удален в будущей версии.
Финализация устарела и может быть удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого объекта Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного времени.

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

WINDOW_FIRST

public static final int WINDOW_FIRST
Первый номер в диапазоне идентификаторов, используемых для событий окна.
См. также:
  • Значения константных полей

WINDOW_OPENED

@Native public static final int WINDOW_OPENED
Событие открытия окна. Это событие доставляется только при первом отображении окна.
См. также:
  • Значения константных полей

WINDOW_CLOSING

@Native public static final int WINDOW_CLOSING
Событие «окно закрывается». Это событие доставляется, когда пользователь пытается закрыть окно с помощью системного меню окна. Если программа явно не скроет окно и не освободит его ресурсы во время обработки этого события, операция закрытия окна будет отменена.
См. также:
  • Значения константных полей

WINDOW_CLOSED

@Native public static final int WINDOW_CLOSED
Событие закрытия окна. Это событие доставляется после закрытия отображаемого окна в результате вызова dispose.
См. также:
  • Component.isDisplayable()
  • Window.dispose()
  • Значения константных полей

WINDOW_ICONIFIED

@Native public static final int WINDOW_ICONIFIED
Событие сворачивания окна. Это событие доставляется, когда окно переходит из обычного состояния в свёрнутое. На многих платформах свёрнутое окно отображается в виде значка, указанного в свойстве iconImage окна.
См. также:
  • Window.setIconImage(Image)
  • Значения константных полей

WINDOW_DEICONIFIED

@Native public static final int WINDOW_DEICONIFIED
Тип события разворачивания окна. Это событие доставляется, когда окно переходит из свёрнутого состояния в обычное.
См. также:
  • Значения константных полей

WINDOW_ACTIVATED

@Native public static final int WINDOW_ACTIVATED
Тип события активации окна. Это событие доставляется, когда Window становится активным Window. Активным Window может быть только Frame или Dialog. Нативная оконная система может обозначать активный Window или его дочерние окна специальным оформлением, например подсвеченной строкой заголовка. Активным Window всегда является либо окно в фокусе, либо первый Frame или Dialog, которому принадлежит окно в фокусе.
См. также:
  • Значения константных полей

WINDOW_DEACTIVATED

@Native public static final int WINDOW_DEACTIVATED
Тип события деактивации окна. Это событие доставляется, когда Window перестаёт быть активным Window. Активным Window может быть только Frame или Dialog. Нативная оконная система может обозначать активный Window или его дочерние окна специальным оформлением, например подсвеченной строкой заголовка. Активным Window всегда является либо окно в фокусе, либо первый Frame или Dialog, которому принадлежит окно в фокусе.
См. также:
  • Значения константных полей

WINDOW_GAINED_FOCUS

@Native public static final int WINDOW_GAINED_FOCUS
Тип события получения фокуса окном. Это событие доставляется, когда Window становится окном в фокусе, то есть когда Window или один из его подкомпонентов будет получать события клавиатуры.
См. также:
  • Значения константных полей

WINDOW_LOST_FOCUS

@Native public static final int WINDOW_LOST_FOCUS
Тип события потери фокуса окном. Это событие доставляется, когда Window перестаёт быть окном в фокусе, то есть события клавиатуры больше не будут доставляться этому Window или любому из его подкомпонентов.
См. также:
  • Значения константных полей

WINDOW_STATE_CHANGED

@Native public static final int WINDOW_STATE_CHANGED
Тип события изменения состояния окна. Это событие доставляется, когда состояние Window изменяется, например при сворачивании или разворачивании.
Начиная с:
1.4
См. также:
  • Значения константных полей

WINDOW_LAST

public static final int WINDOW_LAST
Последний номер в диапазоне идентификаторов, используемых для событий окна.
См. также:
  • Значения константных полей

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

WindowEvent

public WindowEvent(Window source, int id, Window opposite, int oldState, int newState)
Создаёт объект WindowEvent.

Этот метод выбрасывает IllegalArgumentException, если source равно null.

Параметры:
source — объект Window, инициировавший событие
id — целое число, указывающее тип события. Допустимые значения см. в описании класса WindowEvent
opposite — другое окно, участвующее в изменении фокуса или активации, либо null
oldState — предыдущее состояние окна для события изменения состояния окна. Допустимые значения см. в #getOldState()
newState — новое состояние окна для события изменения состояния окна. Допустимые значения см. в #getNewState()
Исключения:
IllegalArgumentException — если source равно null
Начиная с:
1.4
См. также:
  • getWindow()
  • AWTEvent.getID()
  • getOppositeWindow()
  • getOldState()
  • getNewState()

WindowEvent

public WindowEvent(Window source, int id, Window opposite)
Создаёт объект WindowEvent с указанным противоположным Window. Противоположный Window — это другое Window, участвующее в данном изменении фокуса или активации. Для события WINDOW_ACTIVATED или WINDOW_GAINED_FOCUS это Window, потерявшее активацию или фокус. Для события WINDOW_DEACTIVATED или WINDOW_LOST_FOCUS это Window, получившее активацию или фокус. Если это изменение фокуса происходит при взаимодействии с нативным приложением, с Java-приложением в другой виртуальной машине или при отсутствии другого Window, противоположное Window равно null.

Этот метод выбрасывает IllegalArgumentException, если source равно null.

Параметры:
source — объект Window, инициировавший событие
id — целое число, указывающее тип события. Допустимые значения см. в описании класса WindowEvent. Предполагается, что этот конструктор не будет использоваться для типов событий, отличных от WINDOW_ACTIVATED,WINDOW_DEACTIVATED, WINDOW_GAINED_FOCUS или WINDOW_LOST_FOCUS, поскольку противоположное Window для других типов событий всегда будет null. WindowEvent
opposite — другое Window, участвующее в изменении фокуса или активации, либо null
Исключения:
IllegalArgumentException — если source равно null
Начиная с:
1.4
См. также:
  • getWindow()
  • AWTEvent.getID()
  • getOppositeWindow()

WindowEvent

public WindowEvent(Window source, int id, int oldState, int newState)
Создаёт объект WindowEvent с указанными предыдущим и новым состояниями окна.

Этот метод выбрасывает IllegalArgumentException, если source равно null.

Параметры:
source — объект Window, инициировавший событие
id — целое число, указывающее тип события. Допустимые значения см. в описании класса WindowEvent. Предполагается, что этот конструктор не будет использоваться для типов событий, отличных от WINDOW_STATE_CHANGED WindowEvent, поскольку предыдущее и новое состояния окна не имеют смысла для других типов событий.
oldState — целое число, представляющее предыдущее состояние окна. Допустимые значения см. в #getOldState()
newState — целое число, представляющее новое состояние окна. Допустимые значения см. в #getNewState()
Исключения:
IllegalArgumentException — если source равно null
Начиная с:
1.4
См. также:
  • getWindow()
  • AWTEvent.getID()
  • getOldState()
  • getNewState()

WindowEvent

public WindowEvent(Window source, int id)
Создаёт объект WindowEvent.

Этот метод выбрасывает IllegalArgumentException, если source равно null.

Параметры:
source — объект Window, инициировавший событие
id — целое число, указывающее тип события. Допустимые значения см. в описании класса WindowEvent.
Исключения:
IllegalArgumentException — если source равно null
См. также:
  • getWindow()
  • AWTEvent.getID()

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

getWindow

public Window getWindow()
Возвращает инициатор события.
Возвращает:
объект Window, инициировавший событие

getOppositeWindow

public Window getOppositeWindow()
Возвращает другое Window, участвующее в этом изменении фокуса или активации. Для события WINDOW_ACTIVATED или WINDOW_GAINED_FOCUS это Window, потерявшее активацию или фокус. Для события WINDOW_DEACTIVATED или WINDOW_LOST_FOCUS это Window, получившее активацию или фокус. Для любого другого типа WindowEvent, а также если изменение фокуса или активации происходит при взаимодействии с нативным приложением, с Java-приложением в другой виртуальной машине или при отсутствии другого Window, возвращается null.
Возвращает:
другое Window, участвующее в изменении фокуса или активации, либо null
Начиная с:
1.4

getOldState

public int getOldState()
Для событий WINDOW_STATE_CHANGED возвращает предыдущее состояние окна. Состояние представлено в виде побитовой маски.
  • NORMAL
    Указывает, что ни один бит состояния не установлен.
  • ICONIFIED
  • MAXIMIZED_HORIZ
  • MAXIMIZED_VERT
  • MAXIMIZED_BOTH
    Объединяет MAXIMIZED_HORIZ и MAXIMIZED_VERT.
Возвращает:
побитовую маску предыдущего состояния окна
Начиная с:
1.4
См. также:
  • Frame.getExtendedState()

getNewState

public int getNewState()
Для событий WINDOW_STATE_CHANGED возвращает новое состояние окна. Состояние представлено в виде побитовой маски.
  • NORMAL
    Указывает, что ни один бит состояния не установлен.
  • ICONIFIED
  • MAXIMIZED_HORIZ
  • MAXIMIZED_VERT
  • MAXIMIZED_BOTH
    Объединяет MAXIMIZED_HORIZ и MAXIMIZED_VERT.
Возвращает:
побитовую маску нового состояния окна
Начиная с:
1.4
См. также:
  • Frame.getExtendedState()

paramString

public String paramString()
Возвращает строку параметров, идентифицирующую это событие. Этот метод полезен для ведения журнала событий и отладки.
Переопределяет:
paramString в классе ComponentEvent
Возвращает:
строку, идентифицирующую событие и его атрибуты

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её дочерних компаний в США и других странах.
Авторское право © 1993, 2026, Oracle и/или её дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

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