Класс 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, когда оно открывается, закрывается, активируется, деактивируется, минимизируется или восстанавливается, или когда фокус переносится внутрь или наружу окна.

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

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

С:: JDK1.1
См. также:: WindowAdapter, WindowListener, Учебник: Написание обработчика событий окна, Сериализованная форма

Поля

Модификатор и тип	Поле и описание
`static int`	`WINDOW_ACTIVATED` Тип события активации окна.
`static int`	`WINDOW_CLOSED` Событие закрытия окна.
`static int`	`WINDOW_CLOSING` Событие "окно закрывается".
`static int`	`WINDOW_DEACTIVATED` Тип события деактивации окна.
`static int`	`WINDOW_DEICONIFIED` Тип события разминимации окна.
`static int`	`WINDOW_FIRST` Первое число в диапазоне идентификаторов, используемых для событий окон.
`static int`	`WINDOW_GAINED_FOCUS` Тип события получения фокуса окном.
`static int`	`WINDOW_ICONIFIED` Событие минимизации окна.
`static int`	`WINDOW_LAST` Последнее число в диапазоне идентификаторов, используемых для событий окон.
`static int`	`WINDOW_LOST_FOCUS` Тип события потери фокуса окном.
`static int`	`WINDOW_OPENED` Событие открытия окна.
`static 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 окна.

См. также:: Frame.setIconImage(java.awt.Image), Значения константных полей

WINDOW_DEICONIFIED

@Native
public static final int WINDOW_DEICONIFIED

Тип события восстановления окна. Это событие доставляется, когда окно переведено из минимизированного в нормальное состояние.

См. также:: Значения константных полей

WINDOW_ACTIVATED

@Native
public static final int WINDOW_ACTIVATED

Тип события активации окна. Это событие доставляется, когда окно становится активным окном. Активным окном может быть только Frame или Dialog. С помощью системного интерфейса native windowing активное окно или его дочерние элементы могут быть обозначены специальными декорациями, например, выделенной строкой заголовка. Активное окно всегда является либо фокусированным окном, либо первым Frame или Dialog, являющимся владельцем фокусированного окна.

См. также:: Значения константных полей

WINDOW_DEACTIVATED

@Native
public static final int WINDOW_DEACTIVATED

Тип события деактивации окна. Это событие доставляется, когда окно больше не является активным окном. Активным окном может быть только Frame или Dialog. С помощью системного интерфейса native windowing активное окно или его дочерние элементы могут быть обозначены специальными декорациями, например, выделенной строкой заголовка. Активное окно всегда является либо фокусированным окном, либо первым 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_DEACTIVATED или WINDOW_LOST_FOCUS это окно, получившее активацию или фокус. Если это изменение фокуса происходит с помощью native приложения, с приложением Java в другой виртуальной машине или без другого Window, то противоположное окно равно null.

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

Параметры:: source - Объект Window, породивший событие; id - Целое число, указывающее тип события. Сведения о допустимых значениях см. в описании класса WindowEvent. Ожидается, что этот конструктор будет использоваться только для событий WINDOW_ACTIVATED, WINDOW_DEACTIVATED, WINDOW_GAINED_FOCUS, или WINDOW_LOST_FOCUS, потому что противоположное Window других типов событий всегда равно null.; opposite - Другое окно, участвующее в изменении фокуса или активации, или 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, 2020, 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.