Spec-Zone.ru › OpenJDK 25

Класс DefaultKeyboardFocusManager

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

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

Начиная с версии:
1.4
См. также:
  • FocusTraversalPolicy
  • Component.setFocusTraversalKeys(int, Set)
  • Component.getFocusTraversalKeys(int)

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

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

BACKWARD_TRAVERSAL_KEYS, DOWN_CYCLE_TRAVERSAL_KEYS, FORWARD_TRAVERSAL_KEYS, UP_CYCLE_TRAVERSAL_KEYS

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

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

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

Модификатор и тип Метод Описание
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

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

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

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

DefaultKeyboardFocusManager

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

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

dispatchEvent

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

dispatchKeyEvent

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

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

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

postProcessKeyEvent

public boolean postProcessKeyEvent(KeyEvent e)
Этот метод будет вызван методом dispatchKeyEvent. Он обрабатывает все необработанные события KeyEvent, соответствующие MenuShortcut AWT, потребляя событие и активируя сочетание клавиш.
Определено в:
postProcessKeyEvent в интерфейсе KeyEventPostProcessor
Определено в:
postProcessKeyEvent в классе KeyboardFocusManager
Параметры:
e — KeyEvent для последующей обработки
Возвращает:
true
См. также:
  • dispatchKeyEvent(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)
Откладывает диспетчеризацию событий KeyEvent до тех пор, пока указанный компонент не станет владельцем фокуса. События KeyEvent с временными метками, более поздними, чем указанная временная метка, будут помещены в очередь до тех пор, пока указанный компонент не получит событие FOCUS_GAINED или AWT не отменит запрос на задержку, вызвав dequeueKeyEvents или discardKeyEvents.
Определено в:
enqueueKeyEvents в классе KeyboardFocusManager
Параметры:
after — временная метка текущего события либо текущее системное время, если у текущего события нет временной метки или AWT не может определить, какое событие обрабатывается в данный момент
untilFocused — компонент, который получит событие FOCUS_GAINED до любых ожидающих событий KeyEvent
См. также:
  • dequeueKeyEvents(long, Component)
  • discardKeyEvents(Component)

dequeueKeyEvents

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

discardKeyEvents

protected void discardKeyEvents(Component comp)
Отбрасывает все события KeyEvent, поставленные в очередь в результате одного или нескольких вызовов enqueueKeyEvents для указанного компонента или одного из его потомков.
Определено в:
discardKeyEvents в классе KeyboardFocusManager
Параметры:
comp — компонент, указанный в одном или нескольких вызовах enqueueKeyEvents, либо родительский компонент для такого компонента
См. также:
  • enqueueKeyEvents(long, Component)
  • dequeueKeyEvents(long, 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 является окном Window, владельцем фокуса становится компонент, заданный для фокусировки по умолчанию в корне цикла фокуса, а текущий корень цикла фокуса остается неизменным.
Определено в:
upFocusCycle в классе KeyboardFocusManager
Параметры:
aComponent — компонент, служащий основой для операции перемещения фокуса
См. также:
  • Component.transferFocusUpCycle()

downFocusCycle

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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/DefaultKeyboardFocusManager.html

Spec-Zone.ru

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