Spec-Zone.ru › OpenJDK 21

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

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

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

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

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

© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/event/FocusEvent.html

Spec-Zone.ru

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