Spec-Zone.ru › OpenJDK 17

Класс DefaultKeyboardFocusManager

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

Дополнительную информацию см. в разделе «Как использовать подсистему фокуса» в учебнике 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, 2021, 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/17/docs/api/java.desktop/java/awt/DefaultKeyboardFocusManager.html

Spec-Zone.ru

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