Класс FocusManager

javax.swing.FocusManager

Все реализуемые интерфейсы:: KeyEventDispatcher, KeyEventPostProcessor

Прямые известные подклассы:: DefaultFocusManager

public abstract class FocusManager extends DefaultKeyboardFocusManager

Этот класс устарел после появления API управления фокусом версии 1.4. Клиентский код всё ещё может использовать этот класс, однако разработчикам настоятельно рекомендуется вместо него использовать java.awt.KeyboardFocusManager и java.awt.DefaultKeyboardFocusManager.

Дополнительные сведения см. в разделе Как использовать подсистему управления фокусом из учебника по Java и в спецификации управления фокусом.

Начиная с версии:

1.2

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`FOCUS_MANAGER_CLASS_PROPERTY`	Это поле устарело; его использование не рекомендуется, поскольку его спецификация несовместима с API управления фокусом версии 1.4.

Поля, объявленные в классе KeyboardFocusManager

BACKWARD_TRAVERSAL_KEYS, DOWN_CYCLE_TRAVERSAL_KEYS, FORWARD_TRAVERSAL_KEYS, UP_CYCLE_TRAVERSAL_KEYS

Модификатор и тип	Поле	Описание
`static final int`	`BACKWARD_TRAVERSAL_KEYS`	Идентификатор клавиш обхода фокуса в обратном направлении.
`static final int`	`DOWN_CYCLE_TRAVERSAL_KEYS`	Идентификатор клавиш обхода фокуса вниз по циклу.
`static final int`	`FORWARD_TRAVERSAL_KEYS`	Идентификатор клавиш обхода фокуса в прямом направлении.
`static final int`	`UP_CYCLE_TRAVERSAL_KEYS`	Идентификатор клавиш обхода фокуса вверх по циклу.

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

FocusManager()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`static void`	`disableSwingFocusManager()`	Устарел. начиная с версии 1.4 заменён на `KeyboardFocusManager.setDefaultFocusTraversalPolicy(FocusTraversalPolicy)`
`static FocusManager`	`getCurrentManager()`	Возвращает текущий экземпляр `KeyboardFocusManager` для контекста вызывающего потока.
`static boolean`	`isFocusManagerEnabled()`	Устарел. Начиная с версии 1.4 заменён на `KeyboardFocusManager.getDefaultFocusTraversalPolicy()`
`static void`	`setCurrentManager(FocusManager aFocusManager)`	Устанавливает текущий экземпляр `KeyboardFocusManager` для контекста вызывающего потока.

Методы, объявленные в классе DefaultKeyboardFocusManager

dequeueKeyEvents, discardKeyEvents, dispatchEvent, dispatchKeyEvent, downFocusCycle, enqueueKeyEvents, focusNextComponent, focusPreviousComponent, postProcessKeyEvent, processKeyEvent, upFocusCycle

Модификатор и тип	Метод	Описание
`protected void`	`dequeueKeyEvents(long after, Component untilFocused)`	Передаёт для обычной обработки текущему владельцу фокуса все KeyEvent, поставленные в очередь из-за вызова `enqueueKeyEvents` с той же временной меткой и тем же компонентом.
`protected void`	`discardKeyEvents(Component comp)`	Отбрасывает все KeyEvent, поставленные в очередь из-за одного или нескольких вызовов `enqueueKeyEvents` для указанного компонента или одного из его потомков.
`boolean`	`dispatchEvent(AWTEvent e)`	Этот метод вызывается диспетчером событий AWT с просьбой к текущему KeyboardFocusManager обработать указанное событие от его имени.
`boolean`	`dispatchKeyEvent(KeyEvent e)`	Вызывается методом `dispatchEvent`, если ни один другой KeyEventDispatcher в цепочке диспетчеризации не обработал KeyEvent или если другие KeyEventDispatcher не зарегистрированы.
`void`	`downFocusCycle(Container aContainer)`	Перемещает фокус вниз на один цикл обхода фокуса.
`protected void`	`enqueueKeyEvents(long after, Component untilFocused)`	Откладывает обработку KeyEvent до тех пор, пока указанный компонент не станет владельцем фокуса.
`void`	`focusNextComponent(Component aComponent)`	Переводит фокус на компонент, следующий за aComponent; обычно выбор выполняется на основе FocusTraversalPolicy.
`void`	`focusPreviousComponent(Component aComponent)`	Переводит фокус на компонент, предшествующий aComponent; обычно выбор выполняется на основе FocusTraversalPolicy.
`boolean`	`postProcessKeyEvent(KeyEvent e)`	Этот метод будет вызван методом `dispatchKeyEvent`.
`void`	`processKeyEvent(Component focusedComponent, KeyEvent e)`	Этот метод инициирует обход фокуса только в том случае, если KeyEvent представляет собой клавишу обхода фокуса для указанного focusedComponent.
`void`	`upFocusCycle(Component aComponent)`	Перемещает фокус вверх на один цикл обхода фокуса.

Методы, объявленные в классе KeyboardFocusManager

addKeyEventDispatcher, addKeyEventPostProcessor, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, addVetoableChangeListener, clearFocusOwner, clearGlobalFocusOwner, downFocusCycle, firePropertyChange, fireVetoableChange, focusNextComponent, focusPreviousComponent, getActiveWindow, getCurrentFocusCycleRoot, getCurrentKeyboardFocusManager, getDefaultFocusTraversalKeys, getDefaultFocusTraversalPolicy, getFocusedWindow, getFocusOwner, getGlobalActiveWindow, getGlobalCurrentFocusCycleRoot, getGlobalFocusedWindow, getGlobalFocusOwner, getGlobalPermanentFocusOwner, getKeyEventDispatchers, getKeyEventPostProcessors, getPermanentFocusOwner, getPropertyChangeListeners, getPropertyChangeListeners, getVetoableChangeListeners, getVetoableChangeListeners, redispatchEvent, removeKeyEventDispatcher, removeKeyEventPostProcessor, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, removeVetoableChangeListener, setCurrentKeyboardFocusManager, setDefaultFocusTraversalKeys, setDefaultFocusTraversalPolicy, setGlobalActiveWindow, setGlobalCurrentFocusCycleRoot, setGlobalFocusedWindow, setGlobalFocusOwner, setGlobalPermanentFocusOwner, upFocusCycle

Модификатор и тип	Метод	Описание
`void`	`addKeyEventDispatcher(KeyEventDispatcher dispatcher)`	Добавляет KeyEventDispatcher в цепочку диспетчеризации этого KeyboardFocusManager.
`void`	`addKeyEventPostProcessor(KeyEventPostProcessor processor)`	Добавляет KeyEventPostProcessor в цепочку постобработки этого KeyboardFocusManager.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список прослушивателей.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список прослушивателей для определённого свойства.
`void`	`addVetoableChangeListener(VetoableChangeListener listener)`	Добавляет VetoableChangeListener в список прослушивателей.
`void`	`addVetoableChangeListener(String propertyName, VetoableChangeListener listener)`	Добавляет VetoableChangeListener в список прослушивателей для определённого свойства.
`void`	`clearFocusOwner()`	Снимает владельца фокуса на уровне Java и на нативном уровне, если владелец фокуса существует и находится в том же контексте, что и вызывающий поток; в противном случае метод завершается без действий.
`void`	`clearGlobalFocusOwner()`	Снимает глобального владельца фокуса на уровне Java и на нативном уровне.
`final void`	`downFocusCycle()`	Перемещает фокус вниз на один цикл обхода от текущего владельца фокуса, только если текущий владелец фокуса является контейнером — корнем цикла фокуса.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Генерирует PropertyChangeEvent в ответ на изменение связанного свойства.
`protected void`	`fireVetoableChange(String propertyName, Object oldValue, Object newValue)`	Генерирует PropertyChangeEvent в ответ на изменение свойства с возможностью запрета изменения.
`final void`	`focusNextComponent()`	Переводит фокус на компонент, следующий за текущим владельцем фокуса.
`final void`	`focusPreviousComponent()`	Переводит фокус на компонент, предшествующий текущему владельцу фокуса.
`Window`	`getActiveWindow()`	Возвращает активное окно.
`Container`	`getCurrentFocusCycleRoot()`	Возвращает текущий корень цикла фокуса, если он находится в том же контексте, что и вызывающий поток.
`static KeyboardFocusManager`	`getCurrentKeyboardFocusManager()`	Возвращает текущий экземпляр KeyboardFocusManager.
`Set<AWTKeyStroke>`	`getDefaultFocusTraversalKeys(int id)`	Возвращает набор клавиш обхода фокуса по умолчанию для заданной операции обхода.
`FocusTraversalPolicy`	`getDefaultFocusTraversalPolicy()`	Возвращает FocusTraversalPolicy по умолчанию.
`Window`	`getFocusedWindow()`	Возвращает окно, находящееся в фокусе.
`Component`	`getFocusOwner()`	Возвращает владельца фокуса, если он находится в том же контексте, что и вызывающий поток.
`protected Window`	`getGlobalActiveWindow()`	Возвращает активное окно, даже если вызывающий поток находится в контексте, отличном от контекста активного окна.
`protected Container`	`getGlobalCurrentFocusCycleRoot()`	Возвращает текущий корень цикла фокуса, даже если вызывающий поток находится в контексте, отличном от контекста текущего корня цикла фокуса.
`protected Window`	`getGlobalFocusedWindow()`	Возвращает окно, находящееся в фокусе, даже если вызывающий поток находится в контексте, отличном от контекста этого окна.
`protected Component`	`getGlobalFocusOwner()`	Возвращает владельца фокуса, даже если вызывающий поток находится в контексте, отличном от контекста владельца фокуса.
`protected Component`	`getGlobalPermanentFocusOwner()`	Возвращает постоянного владельца фокуса.
`protected List<KeyEventDispatcher>`	`getKeyEventDispatchers()`	Возвращает цепочку KeyEventDispatcher этого KeyboardFocusManager в виде списка.
`protected List<KeyEventPostProcessor>`	`getKeyEventPostProcessors()`	Возвращает цепочку KeyEventPostProcessor этого KeyboardFocusManager в виде списка.
`Component`	`getPermanentFocusOwner()`	Возвращает постоянного владельца фокуса.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех прослушивателей изменений свойств, зарегистрированных в этом менеджере клавиатурного фокуса.
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)`	Возвращает массив всех `PropertyChangeListener`, связанных с указанным свойством.
`VetoableChangeListener[]`	`getVetoableChangeListeners()`	Возвращает массив всех прослушивателей изменений с возможностью запрета, зарегистрированных в этом менеджере клавиатурного фокуса.
`VetoableChangeListener[]`	`getVetoableChangeListeners(String propertyName)`	Возвращает массив всех `VetoableChangeListener`, связанных с указанным свойством.
`final void`	`redispatchEvent(Component target, AWTEvent e)`	Повторно передаёт AWTEvent таким образом, чтобы диспетчер событий AWT не запрашивал рекурсивно у KeyboardFocusManager или установленных KeyEventDispatcher повторную обработку события.
`void`	`removeKeyEventDispatcher(KeyEventDispatcher dispatcher)`	Удаляет KeyEventDispatcher, ранее добавленный в цепочку диспетчеризации этого KeyboardFocusManager.
`void`	`removeKeyEventPostProcessor(KeyEventPostProcessor processor)`	Удаляет ранее добавленный KeyEventPostProcessor из цепочки постобработки этого KeyboardFocusManager.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка прослушивателей.
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка прослушивателей для определённого свойства.
`void`	`removeVetoableChangeListener(VetoableChangeListener listener)`	Удаляет VetoableChangeListener из списка прослушивателей.
`void`	`removeVetoableChangeListener(String propertyName, VetoableChangeListener listener)`	Удаляет VetoableChangeListener из списка прослушивателей для определённого свойства.
`static void`	`setCurrentKeyboardFocusManager(KeyboardFocusManager newManager)`	Устанавливает текущий экземпляр KeyboardFocusManager.
`void`	`setDefaultFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Устанавливает клавиши обхода фокуса по умолчанию для заданной операции обхода.
`void`	`setDefaultFocusTraversalPolicy(FocusTraversalPolicy defaultPolicy)`	Устанавливает FocusTraversalPolicy по умолчанию.
`protected void`	`setGlobalActiveWindow(Window activeWindow)`	Устанавливает активное окно.
`void`	`setGlobalCurrentFocusCycleRoot(Container newFocusCycleRoot)`	Устанавливает текущий корень цикла фокуса.
`protected void`	`setGlobalFocusedWindow(Window focusedWindow)`	Устанавливает окно, находящееся в фокусе.
`protected void`	`setGlobalFocusOwner(Component focusOwner)`	Устанавливает владельца фокуса.
`protected void`	`setGlobalPermanentFocusOwner(Component permanentFocusOwner)`	Устанавливает постоянного владельца фокуса.
`final void`	`upFocusCycle()`	Перемещает фокус вверх на один цикл обхода от текущего владельца фокуса.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 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()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного интервала реального времени.

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

FOCUS_MANAGER_CLASS_PROPERTY

public static final String FOCUS_MANAGER_CLASS_PROPERTY

Это поле устарело; его использование не рекомендуется, поскольку его спецификация несовместима с API управления фокусом версии 1.4. Текущий FocusManager больше не является свойством пользовательского интерфейса. Клиентский код должен получать текущий FocusManager с помощью KeyboardFocusManager.getCurrentKeyboardFocusManager(). Дополнительные сведения см. в спецификации управления фокусом.

См. также:

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

FocusManager

protected FocusManager()

Конструктор для вызова подклассами.

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

getCurrentManager

public static FocusManager getCurrentManager()

Возвращает текущий экземпляр KeyboardFocusManager для контекста вызывающего потока.

Возвращает:

KeyboardFocusManager контекста этого потока

См. также:

setCurrentManager

public static void setCurrentManager(FocusManager aFocusManager)

Устанавливает текущий экземпляр KeyboardFocusManager для контекста вызывающего потока. Если указано значение null, текущий KeyboardFocusManager заменяется новым экземпляром DefaultKeyboardFocusManager.

Параметры:

aFocusManager — новый KeyboardFocusManager для контекста этого потока

См. также:

disableSwingFocusManager

@Deprecated public static void disableSwingFocusManager()

Устарел.

начиная с версии 1.4 заменён на KeyboardFocusManager.setDefaultFocusTraversalPolicy(FocusTraversalPolicy)

Изменяет значение FocusTraversalPolicy по умолчанию для текущего KeyboardFocusManager на DefaultFocusTraversalPolicy.

См. также:

isFocusManagerEnabled

@Deprecated public static boolean isFocusManagerEnabled()

Устарел.

Начиная с версии 1.4 заменён на KeyboardFocusManager.getDefaultFocusTraversalPolicy()

Возвращает, вызывало ли приложение метод disableSwingFocusManager().

Возвращает:

true, если менеджер фокуса включён.

См. также:

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