Spec-Zone.ru › OpenJDK 21

Класс 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, 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 до тех пор, пока указанный Component не станет владельцем фокуса. KeyEvents с отметками времени позже указанной отметки времени будут помещены в очередь до тех пор, пока указанный Component не получит событие 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, 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/DefaultKeyboardFocusManager.html

Spec-Zone.ru

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