Spec-Zone.ru › OpenJDK 27

Класс FocusEvent

java.lang.Object
java.util.EventObject
java.awt.AWTEvent
java.awt.event.ComponentEvent
java.awt.event.FocusEvent
Все реализуемые интерфейсы:
Serializable
public class FocusEvent extends ComponentEvent
Низкоуровневое событие, указывающее, что компонент получил или потерял фокус ввода. Это низкоуровневое событие генерируется компонентом (например, TextField). Событие передается каждому объекту FocusListener или FocusAdapter, зарегистрированному для получения таких событий с помощью метода addFocusListener компонента. (Объекты FocusAdapter реализуют интерфейс FocusListener.) Каждый такой объект-слушатель получает это FocusEvent при возникновении события.

Существует два типа событий фокуса: постоянные и временные. События постоянного изменения фокуса возникают, когда фокус непосредственно перемещается с одного компонента на другой, например при вызове requestFocus() или при перемещении пользователя по компонентам с помощью клавиши TAB. События временного изменения фокуса возникают, когда компонент временно теряет фокус косвенно, в результате другой операции, например деактивации окна или перетаскивания полосы прокрутки. В этом случае исходное состояние фокуса восстанавливается автоматически после завершения операции или, в случае деактивации окна, после повторной активации окна. Как постоянные, так и временные события фокуса передаются с помощью идентификаторов событий FOCUS_GAINED и FOCUS_LOST; тип события можно определить с помощью метода isTemporary().

Каждый FocusEvent фиксирует причину возникновения события. Причина назначается при создании события фокуса и может быть получена вызовом getCause().

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

Начиная с:
1.1
См. также:
  • FocusAdapter
  • FocusListener
  • Учебное руководство: написание слушателя фокуса
  • Сериализованная форма

Краткое описание вложенных классов

Модификатор и тип Класс Описание
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
Это событие указывает, что компонент больше не является владельцем фокуса.

Поля, объявленные в классе 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
Объект, в отношении которого изначально произошло событие.

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

Конструктор Описание
FocusEvent(Component source, int id)
Создает объект FocusEvent и обозначает изменение фокуса как постоянное.
FocusEvent(Component source, int id, boolean temporary)
Создает объект FocusEvent и указывает, является ли изменение временным.
FocusEvent(Component source, int id, boolean temporary, Component opposite)
Создает объект FocusEvent с указанным временным состоянием, противоположным компонентом Component и причиной Cause.UNKNOWN.
FocusEvent(Component source, int id, boolean temporary, Component opposite, FocusEvent.Cause cause)
Создает объект FocusEvent с указанным временным состоянием, противоположным компонентом Component и причиной.

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

Модификатор и тип Метод Описание
final FocusEvent.Cause getCause()
Возвращает причину события.
Component getOppositeComponent()
Возвращает другой компонент, участвующий в этом изменении фокуса.
boolean isTemporary()
Определяет, является ли событие изменения фокуса временным или постоянным.
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()
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного интервала реального времени.

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

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
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • isTemporary()
  • getOppositeComponent()
  • FocusEvent.Cause.UNKNOWN

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
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • isTemporary()
  • getOppositeComponent()
  • FocusEvent.Cause

FocusEvent

public FocusEvent(Component source, int id, boolean temporary)
Создает объект FocusEvent и указывает, является ли изменение временным.

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

Параметры:
source — Component, являющийся источником события
id — целое число, указывающее тип события. Допустимые значения описаны в документации класса FocusEvent
temporary — равно true, если изменение фокуса является временным; в противном случае — false
Выбрасывает:
IllegalArgumentException — если source равно null
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()
  • isTemporary()

FocusEvent

public FocusEvent(Component source, int id)
Создает объект FocusEvent и обозначает изменение фокуса как постоянное.

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

Параметры:
source — Component, являющийся источником события
id — целое число, указывающее тип события. Допустимые значения описаны в документации класса FocusEvent
Выбрасывает:
IllegalArgumentException — если source равно null
См. также:
  • EventObject.getSource()
  • AWTEvent.getID()

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

isTemporary

public boolean isTemporary()
Определяет, является ли событие изменения фокуса временным или постоянным.
Возвращает:
true, если изменение фокуса является временным; в противном случае — false

getOppositeComponent

public Component getOppositeComponent()
Возвращает другой компонент, участвующий в этом изменении фокуса. Для события FOCUS_GAINED это компонент, потерявший фокус. Для события FOCUS_LOST это компонент, получивший фокус. Если изменение фокуса происходит в нативном приложении, в Java-приложении в другой виртуальной машине или при отсутствии другого компонента, возвращается null.
Возвращает:
другой компонент, участвующий в изменении фокуса, или null
Начиная с:
1.4

paramString

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

getCause

public final FocusEvent.Cause getCause()
Возвращает причину события.
Возвращает:
одно из значений FocusEvent.Cause
Начиная с:
9

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по 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