Класс 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().

Неопределённое поведение будет вызвано, если параметр id любого конкретного экземпляра FocusEvent не находится в диапазоне от FOCUS_FIRST до FOCUS_LAST.

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

Поля

Модификатор и тип	Поле и описание
`static int`	`FOCUS_FIRST` Первое число в диапазоне идентификаторов, используемых для событий фокуса.
`static int`	`FOCUS_GAINED` Это событие указывает, что компонент теперь является владельцем фокуса.
`static int`	`FOCUS_LAST` Последнее число в диапазоне идентификаторов, используемых для событий фокуса.
`static 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`.

Методы

Модификатор и тип	Метод и описание
`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. Противоположный 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

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
Возвращает:: строку, идентифицирующую событие и его атрибуты

© 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.