Spec-Zone.ru › OpenJDK 24

Класс 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
Тип события изменения состояния окна.

Поля, объявленные в классе java.awt.event.ComponentEvent

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

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

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

Конструктор Описание
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()
Возвращает строку параметра, идентифицирующую это событие.

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

getComponent

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

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

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(java.awt.Image)
  • Значения константных полей

WINDOW_DEICONIFIED

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

WINDOW_ACTIVATED

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

WINDOW_DEACTIVATED

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

WINDOW_GAINED_FOCUS

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

WINDOW_LOST_FOCUS

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

WINDOW_STATE_CHANGED

@Native public static final int WINDOW_STATE_CHANGED
Тип события изменения состояния окна. Это событие доставляется, когда состояние окна меняется, например, при минимизации или максимизации.
С момента:
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
Возвращает:
строка, идентифицирующая событие и его атрибуты

© 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/WindowEvent.html

Spec-Zone.ru

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