Класс FocusEvent
- Все реализованные интерфейсы:
Serializable
public class FocusEvent extends ComponentEvent
FocusListener или FocusAdapter, который зарегистрирован для получения таких событий с помощью метода addFocusListener компонента. (Объекты FocusAdapter реализуют интерфейс FocusListener. ) Каждый такой объект-слушатель получает это событие FocusEvent при его возникновении. Существуют два уровня событий фокуса: постоянные и временные. Постоянные события изменения фокуса возникают при непосредственном перемещении фокуса с одного компонента на другой, например, посредством вызова requestFocus() или при использовании пользователем клавиши TAB для перехода между компонентами. Временные события изменения фокуса возникают при временной потере фокуса компонентом в результате другого действия, например, деактивации окна или перетаскивания ползунка скроллбара. В этом случае первоначальное состояние фокуса будет автоматически восстановлено после завершения операции или, в случае деактивации окна, при его повторной активации. Как постоянные, так и временные события фокуса доставляются с помощью идентификаторов событий FOCUS_GAINED и FOCUS_LOST; уровень может быть определён в событии с помощью метода isTemporary().
Каждый объект FocusEvent записывает свою причину – причину, по которой это событие было сгенерировано. Причина присваивается во время создания события фокуса и может быть получена с помощью вызова getCause().
Неопределённое поведение будет вызвано, если параметр id любого экземпляра FocusEvent не находится в диапазоне от FOCUS_FIRST до FOCUS_LAST.
- С тех пор:
- 1.1
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
static enum |
FocusEvent.Cause |
Этот перечисление представляет причину события FocusEvent — причину его возникновения. |
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
FOCUS_FIRST |
Первое число в диапазоне идентификаторов, используемых для событий фокуса. |
static final int |
FOCUS_GAINED |
Это событие указывает, что компонент теперь является владельцем фокуса. |
static final int |
FOCUS_LAST |
Последнее число в диапазоне идентификаторов, используемых для событий фокуса. |
static final int |
FOCUS_LOST |
Это событие указывает, что компонент больше не является владельцем фокуса. |
Поля, объявленные в классе 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
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
FocusEvent |
Создаёт объект FocusEvent и идентифицирует его как постоянное изменение фокуса. |
FocusEvent |
Создаёт объект FocusEvent и идентифицирует, является ли изменение временным. |
FocusEvent |
Создаёт объект FocusEvent с указанным временным состоянием, противоположным Component, и причиной Cause.UNKNOWN. |
FocusEvent |
Создаёт объект FocusEvent с указанным временным состоянием, противоположным Component, и причиной. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final FocusEvent.Cause |
getCause() |
Возвращает причину события. |
Component |
getOppositeComponent() |
Возвращает другой компонент, участвующий в этом изменении фокуса. |
boolean |
isTemporary() |
Идентифицирует событие изменения фокуса как временное или постоянное. |
String |
paramString() |
Возвращает строку-параметр, идентифицирующую это событие. |
Методы, объявленные в классе java.awt.event.ComponentEvent
getComponent
Методы, объявленные в классе java.util.EventObject
getSource
Подробное описание полей
FOCUS_FIRST
public static final int FOCUS_FIRST
- См. также:
FOCUS_LAST
public static final int FOCUS_LAST
- См. также:
FOCUS_GAINED
public static final int FOCUS_GAINED
- См. также:
FOCUS_LOST
public static final int FOCUS_LOST
- См. также:
Подробное описание конструкторов
FocusEvent
public FocusEvent(Component source, int id, boolean temporary, Component opposite)
FocusEvent с указанным временным состоянием, противоположным Component и причиной Cause.UNKNOWN. Противоположный Component — это другой Component, участвующий в этом изменении фокуса. Для события FOCUS_GAINED, это Component, который потерял фокус. Для события FOCUS_LOST, это Component, который получил фокус. Если это изменение фокуса происходит с собственным приложением, с Java-приложением в другой виртуальной машине или без другого Component, то противоположный Component равен null. Этот метод создает исключение IllegalArgumentException, если source равен null.
- Параметры:
-
source-Component, который инициировал событие -
id- Целое число, указывающее тип события. Для получения информации о допустимых значениях см. описание классаFocusEvent -
temporary- Равноtrue, если изменение фокуса является временным;falseв противном случае -
opposite- Другой компонент, участвующий в изменении фокуса, илиnull - Исключения:
-
IllegalArgumentException- еслиsourceравноnull - С версии:
- 1.4
- См. также:
FocusEvent
public FocusEvent(Component source, int id, boolean temporary, Component opposite, FocusEvent.Cause cause)
FocusEvent с указанным временным состоянием, противоположным Component и причиной. Противоположный Component — это другой Component, участвующий в этом изменении фокуса. Для события FOCUS_GAINED, это Component, который потерял фокус. Для события FOCUS_LOST, это Component, который получил фокус. Если это изменение фокуса происходит с собственным приложением, с Java-приложением в другой виртуальной машине или без другого Component, то противоположный Component равен null. Этот метод создает исключение IllegalArgumentException, если source или cause равно null.
- Параметры:
-
source-Component, который инициировал событие -
id- Целое число, указывающее тип события. Для получения информации о допустимых значениях см. описание классаFocusEvent -
temporary- Равноtrue, если изменение фокуса является временным;falseв противном случае -
opposite- Другой компонент, участвующий в изменении фокуса, илиnull -
cause- Причина события фокуса. - Исключения:
-
IllegalArgumentException- еслиsourceравноnullили еслиcauseравноnull - С версии:
- 9
- См. также:
FocusEvent
public FocusEvent(Component source, int id, boolean temporary)
FocusEvent и определяет, является ли изменение временным. Этот метод создает исключение IllegalArgumentException, если source равно null.
- Параметры:
-
source-Component, который инициировал событие -
id- Целое число, указывающее тип события. Для получения информации о допустимых значениях см. описание классаFocusEvent -
temporary- Равноtrue, если изменение фокуса является временным;falseв противном случае - Исключения:
-
IllegalArgumentException- еслиsourceравноnull - См. также:
FocusEvent
public FocusEvent(Component source, int id)
FocusEvent и определяет его как постоянное изменение фокуса. Этот метод создает исключение IllegalArgumentException, если source равно null.
- Параметры:
-
source-Component, который инициировал событие -
id- Целое число, указывающее тип события. Для получения информации о допустимых значениях см. описание классаFocusEvent - Исключения:
-
IllegalArgumentException- еслиsourceравноnull - См. также:
Подробное описание методов
isTemporary
public boolean isTemporary()
- Возвращает:
-
true, если изменение фокуса является временным;falseв противном случае
getOppositeComponent
public Component getOppositeComponent()
- Возвращает:
- другой компонент, участвующий в изменении фокуса, или null
- С версии:
- 1.4
paramString
public String paramString()
- Переопределяет:
-
paramStringв классеComponentEvent - Возвращает:
- строку, идентифицирующую событие и его атрибуты
getCause
public final FocusEvent.Cause getCause()
- Возвращает:
- одно из значений
FocusEvent.Cause - С версии:
- 9
© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/event/FocusEvent.html