Spec-Zone.ru › OpenJDK 25

Класс 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

Поля, объявленные в классе 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

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

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

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

consume, getID, isConsumed, setSource, toString

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

getSource

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

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 становится активным окном. Активным окном может быть только Frame или Dialog. Нативная оконная система может выделять активное окно или его дочерние окна специальным оформлением, например подсвеченной строкой заголовка. Активное окно всегда является либо окном с фокусом, либо первым Frame или Dialog, которому принадлежит окно с фокусом.
См. также:
  • Значения константных полей

WINDOW_DEACTIVATED

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

WINDOW_GAINED_FOCUS

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

WINDOW_LOST_FOCUS

@Native public static final int WINDOW_LOST_FOCUS
Тип события потери фокуса окном. Это событие доставляется, когда 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, противоположное окно имеет значение null.

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

Параметры:
source — объект Window, являющийся источником события
id — целое число, указывающее тип события. Допустимые значения см. в описании класса WindowEvent. Предполагается, что этот конструктор будет использоваться только для событий WINDOW_ACTIVATED,WINDOW_DEACTIVATED, WINDOW_GAINED_FOCUS или WINDOW_LOST_FOCUS. Для типов WindowEvent противоположное Window других типов событий всегда будет иметь значение null.
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_ACTIVATED или WINDOW_GAINED_FOCUS это окно, потерявшее активацию или фокус. Для события WINDOW_DEACTIVATED или WINDOW_LOST_FOCUS это окно, получившее активацию или фокус. Для любого другого типа WindowEvent, а также если изменение фокуса или активации происходит при взаимодействии с нативным приложением, приложением Java в другой виртуальной машине или контексте либо при отсутствии другого окна, возвращается null.
Возвращает:
другое окно, участвующее в изменении фокуса или активации, либо 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, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/event/WindowEvent.html

Spec-Zone.ru

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