Spec-Zone.ru › OpenJDK 25

Класс LayoutFocusTraversalPolicy

java.lang.Object
java.awt.FocusTraversalPolicy
javax.swing.InternalFrameFocusTraversalPolicy
javax.swing.SortingFocusTraversalPolicy
javax.swing.LayoutFocusTraversalPolicy
Все реализуемые интерфейсы:
Serializable
public class LayoutFocusTraversalPolicy extends SortingFocusTraversalPolicy implements Serializable
SortingFocusTraversalPolicy, который упорядочивает компоненты на основе их размера, положения и ориентации. На основе размера и положения компоненты приблизительно распределяются по строкам и столбцам. Для контейнера с горизонтальной ориентацией столбцы располагаются слева направо или справа налево, а строки — сверху вниз. Для контейнера с вертикальной ориентацией столбцы располагаются сверху вниз, а строки — слева направо или справа налево. Дополнительные сведения см. в ComponentOrientation. Все столбцы в строке обходятся полностью, прежде чем перейти к следующей строке.
Начиная с версии:
1.4
См. также:
  • ComponentOrientation

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

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

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

Модификатор и тип Метод Описание
protected boolean accept(Component aComponent)
Определяет, является ли указанный Component допустимым кандидатом на роль нового владельца фокуса.
Component getComponentAfter(Container aContainer, Component aComponent)
Возвращает компонент, который должен получить фокус после aComponent. aContainer должен быть корнем цикла фокуса для aComponent.
Component getComponentBefore(Container aContainer, Component aComponent)
Возвращает компонент, который должен получить фокус перед aComponent. aContainer должен быть корнем цикла фокуса для aComponent.
Component getFirstComponent(Container aContainer)
Возвращает первый компонент в цикле обхода.
Component getLastComponent(Container aContainer)
Возвращает последний компонент в цикле обхода.

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

getComparator, getDefaultComponent, getImplicitDownCycleTraversal, setComparator, setImplicitDownCycleTraversal

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

getInitialComponent

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

getInitialComponent

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

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

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

LayoutFocusTraversalPolicy

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

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

getComponentAfter

public Component getComponentAfter(Container aContainer, Component aComponent)
Возвращает компонент, который должен получить фокус после aComponent. aContainer должен быть корнем цикла фокуса для aComponent.

По умолчанию LayoutFocusTraversalPolicy неявно передает фокус по нисходящему циклу. То есть при обычном обходе фокуса компонентом, следующим после корня цикла фокуса, будет компонент по умолчанию, на который передается фокус для этого корня цикла. Это поведение можно отключить с помощью метода setImplicitDownCycleTraversal.

Если aContainer является поставщиком политики обхода фокуса, фокус всегда передается по нисходящему циклу.

Переопределяет:
getComponentAfter в классе SortingFocusTraversalPolicy
Параметры:
aContainer — корень цикла фокуса для aComponent или поставщик политики обхода фокуса
aComponent — (возможно, косвенный) дочерний элемент aContainer или сам aContainer
Возвращает:
компонент, который должен получить фокус после aComponent, или null, если подходящий компонент не найден
Вызывает исключение:
IllegalArgumentException — если aContainer не является корнем цикла фокуса для aComponent или поставщиком политики обхода фокуса либо если aContainer или aComponent равен null

getComponentBefore

public Component getComponentBefore(Container aContainer, Component aComponent)
Возвращает компонент, который должен получить фокус перед aComponent. aContainer должен быть корнем цикла фокуса для aComponent.

По умолчанию LayoutFocusTraversalPolicy неявно передает фокус по нисходящему циклу. То есть при обычном обходе фокуса компонентом, следующим после корня цикла фокуса, будет компонент по умолчанию, на который передается фокус для этого корня цикла. Это поведение можно отключить с помощью метода setImplicitDownCycleTraversal.

Если aContainer является поставщиком политики обхода фокуса, фокус всегда передается по нисходящему циклу.

Переопределяет:
getComponentBefore в классе SortingFocusTraversalPolicy
Параметры:
aContainer — корень цикла фокуса для aComponent или поставщик политики обхода фокуса
aComponent — (возможно, косвенный) дочерний элемент aContainer или сам aContainer
Возвращает:
компонент, который должен получить фокус перед aComponent, или null, если подходящий компонент не найден
Вызывает исключение:
IllegalArgumentException — если aContainer не является корнем цикла фокуса для aComponent или поставщиком политики обхода фокуса либо если aContainer или aComponent равен null

getFirstComponent

public Component getFirstComponent(Container aContainer)
Возвращает первый компонент в цикле обхода. Этот метод используется для определения следующего компонента, которому будет передан фокус, когда обход в прямом направлении начинается заново.
Переопределяет:
getFirstComponent в классе SortingFocusTraversalPolicy
Параметры:
aContainer — корень цикла фокуса для aComponent или поставщик политики обхода фокуса, первый компонент которого требуется вернуть
Возвращает:
первый компонент в цикле обхода aContainer или null, если подходящий компонент не найден
Вызывает исключение:
IllegalArgumentException — если aContainer равен null

getLastComponent

public Component getLastComponent(Container aContainer)
Возвращает последний компонент в цикле обхода. Этот метод используется для определения следующего компонента, которому будет передан фокус, когда обход в обратном направлении начинается заново.
Переопределяет:
getLastComponent в классе SortingFocusTraversalPolicy
Параметры:
aContainer — корень цикла фокуса для aComponent или поставщик политики обхода фокуса, последний компонент которого требуется вернуть
Возвращает:
последний компонент в цикле обхода aContainer или null, если подходящий компонент не найден
Вызывает исключение:
IllegalArgumentException — если aContainer равен null

accept

protected boolean accept(Component aComponent)
Определяет, является ли указанный Component допустимым кандидатом на роль нового владельца фокуса. Метод выполняет следующую последовательность действий:
  1. Проверяет, является ли aComponent видимым, отображаемым, включенным и доступным для фокусировки. Если хотя бы одно из этих свойств имеет значение false, метод возвращает false.
  2. Если aComponent является экземпляром JTable, возвращает true.
  3. Если aComponent является экземпляром JComboBox, возвращает значение aComponent.getUI().isFocusTraversable(aComponent).
  4. Если aComponent является JComponent с JComponent.WHEN_FOCUSED InputMap, который не является ни null, ни пустым, возвращает true.
  5. Возвращает значение DefaultFocusTraversalPolicy.accept(aComponent).
Переопределяет:
accept в классе SortingFocusTraversalPolicy
Параметры:
aComponent — Component, пригодность которого в качестве владельца фокуса требуется проверить
Возвращает:
true, если aComponent является допустимым кандидатом на роль владельца фокуса; в противном случае — false
См. также:
  • Component.isVisible()
  • Component.isDisplayable()
  • Component.isEnabled()
  • Component.isFocusable()
  • ComboBoxUI.isFocusTraversable(JComboBox)
  • JComponent.getInputMap(int)
  • DefaultFocusTraversalPolicy.accept(Component)

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по 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/javax/swing/LayoutFocusTraversalPolicy.html

Spec-Zone.ru

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