Spec-Zone.ru › OpenJDK 24

Класс DefaultKeyboardFocusManager

java.lang.Object
java.awt.KeyboardFocusManager
java.awt.DefaultKeyboardFocusManager
Все реализованные интерфейсы:
KeyEventDispatcher, KeyEventPostProcessor
Прямые известные подклассы:
FocusManager
public class DefaultKeyboardFocusManager extends KeyboardFocusManager
По умолчанию KeyboardFocusManager для приложений AWT. Перемещение фокуса выполняется в ответ на клавиши перемещения фокуса компонента и с помощью FocusTraversalPolicy контейнера.

Подробнее см. Как использовать подсистему фокуса — раздел в Java Tutorial — и Спецификацию фокуса.

С тех пор:
1.4
См. также:
  • FocusTraversalPolicy
  • Component.setFocusTraversalKeys(int, java.util.Set<? extends java.awt.AWTKeyStroke>)
  • Component.getFocusTraversalKeys(int)

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

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

BACKWARD_TRAVERSAL_KEYS, DOWN_CYCLE_TRAVERSAL_KEYS, FORWARD_TRAVERSAL_KEYS, UP_CYCLE_TRAVERSAL_KEYS

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

Конструктор Описание
DefaultKeyboardFocusManager()
Создаёт DefaultKeyboardFocusManager.

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

Модификатор и тип Метод Описание
protected void dequeueKeyEvents(long after, Component untilFocused)
Освобождает для обычной обработки текущим владельцем фокуса все KeyEvents, которые были помещены в очередь из-за вызова enqueueKeyEvents с той же меткой времени и компонентом.
protected void discardKeyEvents(Component comp)
Удаляет все KeyEvents, которые были помещены в очередь из-за одного или нескольких вызовов enqueueKeyEvents с указанным компонентом или одним из его потомков.
boolean dispatchEvent(AWTEvent e)
Этот метод вызывается диспетчером событий AWT, запрашивая, чтобы текущий KeyboardFocusManager обработать указанное событие от его имени.
boolean dispatchKeyEvent(KeyEvent e)
Вызывается dispatchEvent, если ни один другой KeyEventDispatcher в цепочке диспетчеров не обработает KeyEvent или если другие KeyEventDispatchers не зарегистрированы.
void downFocusCycle(Container aContainer)
Перемещает фокус вниз на один цикл перемещения фокуса.
protected void enqueueKeyEvents(long after, Component untilFocused)
Откладывает обработку KeyEvents до тех пор, пока указанный компонент не станет владельцем фокуса.
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)
Перемещает фокус вверх на один цикл перемещения фокуса.

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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

DefaultKeyboardFocusManager

public DefaultKeyboardFocusManager()
Создаёт DefaultKeyboardFocusManager.

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

dispatchEvent

public boolean dispatchEvent(AWTEvent e)
Этот метод вызывается диспетчером событий AWT, который запрашивает, чтобы текущий KeyboardFocusManager обработал указанное событие от его имени. DefaultKeyboardFocusManagers обрабатывают все FocusEvents, все WindowEvents, связанные с фокусом, и все KeyEvents. Эти события обрабатываются на основе представления KeyboardFocusManager о владельце фокуса и фокусированных и активных окнах, иногда переопределяя источник указанного события AWTEvent. Если этот метод возвращает false, то диспетчер событий AWT попытается обработать событие сам.
Определено в:
dispatchEvent в классе KeyboardFocusManager
Параметры:
e — обрабатываемое событие AWTEvent
Возвращает:
true, если этот метод обработал событие; false в противном случае
См. также:
  • KeyboardFocusManager.redispatchEvent(java.awt.Component, java.awt.AWTEvent)
  • KeyboardFocusManager.dispatchKeyEvent(java.awt.event.KeyEvent)

dispatchKeyEvent

public boolean dispatchKeyEvent(KeyEvent e)
Вызывается dispatchEvent, если ни один другой KeyEventDispatcher в цепочке диспетчеров не обработал KeyEvent или если другие KeyEventDispatchers не зарегистрированы. Если событие не было обработано, его целевой компонент активен, а владелец фокуса не null, этот метод обрабатывает событие в своей цели. Этот метод также впоследствии обработает событие во всех зарегистрированных KeyEventPostProcessors. После завершения всех этих операций событие передаётся виджетам для обработки.

В любом случае этот метод возвращает true, поскольку DefaultKeyboardFocusManager спроектирован так, чтобы ни dispatchEvent, ни диспетчер событий AWT не должны были предпринимать дальнейших действий по событию в любой ситуации.

Определено в:
dispatchKeyEvent в интерфейсе KeyEventDispatcher
Определено в:
dispatchKeyEvent в классе KeyboardFocusManager
Параметры:
e — обрабатываемое событие KeyEvent
Возвращает:
true
См. также:
  • Component.dispatchEvent(java.awt.AWTEvent)

postProcessKeyEvent

public boolean postProcessKeyEvent(KeyEvent e)
Этот метод вызывается dispatchKeyEvent. Он обрабатывает любые необработанные KeyEvents, которые соответствуют AWT-MenuShortcut, потребляя событие и активируя ярлык.
Определено в:
postProcessKeyEvent в интерфейсе KeyEventPostProcessor
Определено в:
postProcessKeyEvent в классе KeyboardFocusManager
Параметры:
e — обрабатываемое событие KeyEvent
Возвращает:
true
См. также:
  • dispatchKeyEvent(java.awt.event.KeyEvent)
  • MenuShortcut

processKeyEvent

public void processKeyEvent(Component focusedComponent, KeyEvent e)
Этот метод инициирует операцию перемещения фокуса только в том случае, если KeyEvent представляет собой клавишу перемещения фокуса для указанного focusedComponent. Ожидается, что focusedComponent является текущим владельцем фокуса, хотя это необязательно. Если это не так, перемещение фокуса всё равно произойдёт так, как если бы focusedComponent был владельцем фокуса.
Определено в:
processKeyEvent в классе KeyboardFocusManager
Параметры:
focusedComponent — компонент, являющийся основой операции перемещения фокуса, если указанное событие представляет собой клавишу перемещения фокуса для компонента
e — событие, которое может представлять собой клавишу перемещения фокуса

enqueueKeyEvents

protected void enqueueKeyEvents(long after, Component untilFocused)
Задерживает обработку KeyEvents до тех пор, пока указанный компонент не станет владельцем фокуса. KeyEvents с отметками времени, более поздними, чем указанная отметка времени, будут помещены в очередь до тех пор, пока указанный компонент не получит событие FOCUS_GAINED или AWT не отменит запрос задержки, вызвав dequeueKeyEvents или discardKeyEvents.
Определено в:
enqueueKeyEvents в классе KeyboardFocusManager
Параметры:
after — отметка времени текущего события или текущее системное время, если текущее событие не имеет отметки времени или AWT не может определить, какое событие в настоящее время обрабатывается
untilFocused — компонент, который получит событие FOCUS_GAINED перед любыми ожидающими KeyEvents
См. также:
  • dequeueKeyEvents(long, java.awt.Component)
  • discardKeyEvents(java.awt.Component)

dequeueKeyEvents

protected void dequeueKeyEvents(long after, Component untilFocused)
Освобождает для обработки текущим владельцем фокуса все KeyEvents, которые были помещены в очередь из-за вызова enqueueKeyEvents с той же отметкой времени и компонентом. Если заданная отметка времени меньше нуля, запрос на посылку в очередь для данного компонента с самой старой отметкой времени (если таковой имеется) должен быть отменён.
Определено в:
dequeueKeyEvents в классе KeyboardFocusManager
Параметры:
after — отметка времени, указанная при вызове enqueueKeyEvents, или любое значение < 0
untilFocused — компонент, указанный при вызове enqueueKeyEvents
См. также:
  • enqueueKeyEvents(long, java.awt.Component)
  • discardKeyEvents(java.awt.Component)

discardKeyEvents

protected void discardKeyEvents(Component comp)
Отбрасывает все KeyEvents, помещённые в очередь из-за одного или нескольких вызовов enqueueKeyEvents с указанным компонентом или одним из его потомков.
Определено в:
discardKeyEvents в классе KeyboardFocusManager
Параметры:
comp — компонент, указанный в одном или нескольких вызовах enqueueKeyEvents или родитель такого компонента
См. также:
  • enqueueKeyEvents(long, java.awt.Component)
  • dequeueKeyEvents(long, java.awt.Component)

focusPreviousComponent

public void focusPreviousComponent(Component aComponent)
Переводит фокус на компонент, расположенный перед aComponent, обычно на основе FocusTraversalPolicy.
Определено в:
focusPreviousComponent в классе KeyboardFocusManager
Параметры:
aComponent — компонент, являющийся основой операции перемещения фокуса
См. также:
  • FocusTraversalPolicy
  • Component.transferFocusBackward()

focusNextComponent

public void focusNextComponent(Component aComponent)
Переводит фокус на компонент, расположенный после aComponent, обычно на основе FocusTraversalPolicy.
Определено в:
focusNextComponent в классе KeyboardFocusManager
Параметры:
aComponent — компонент, являющийся основой операции перемещения фокуса
См. также:
  • FocusTraversalPolicy
  • Component.transferFocus()

upFocusCycle

public void upFocusCycle(Component aComponent)
Перемещает фокус на один цикл вверх. Как правило, владелец фокуса устанавливается в корень цикла фокуса aComponent, а текущий корень цикла фокуса — в корень цикла фокуса нового владельца фокуса. Однако если корень цикла фокуса aComponent является окном, то владелец фокуса устанавливается в умолчанный компонент для фокуса корня цикла фокуса, а текущий корень цикла фокуса остаётся неизменным.
Определено в:
upFocusCycle в классе KeyboardFocusManager
Параметры:
aComponent — компонент, являющийся основой операции перемещения фокуса
См. также:
  • Component.transferFocusUpCycle()

downFocusCycle

public void downFocusCycle(Container aContainer)
Перемещает фокус на один цикл вниз. Если aContainer является корнем цикла фокуса, то владелец фокуса устанавливается в умолчанный компонент для фокуса aContainer, а текущий корень цикла фокуса — в aContainer. Если aContainer не является корнем цикла фокуса, то операция перемещения фокуса не выполняется.
Определено в:
downFocusCycle в классе KeyboardFocusManager
Параметры:
aContainer — контейнер, являющийся основой операции перемещения фокуса
См. также:
  • Container.transferFocusDownCycle()

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/DefaultKeyboardFocusManager.html

Spec-Zone.ru

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