Spec-Zone.ru › OpenJDK 24

Класс LayoutFocusTraversalPolicy

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

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

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

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

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

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

getComparator, getDefaultComponent, getImplicitDownCycleTraversal, setComparator, setImplicitDownCycleTraversal

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

getInitialComponent

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

getInitialComponent

Методы, объявленные в классе java.lang.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 является поставщиком политики перемещения фокуса, фокус всегда передается вниз по циклу.

Overrides:
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 является поставщиком политики перемещения фокуса, фокус всегда передается вниз по циклу.

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

getFirstComponent

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

getLastComponent

public Component getLastComponent(Container aContainer)
Возвращает последний компонент в цикле перемещения. Этот метод используется для определения следующего компонента для фокусировки при переходе по циклу в обратном направлении.
Overrides:
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).
Overrides:
accept в классе SortingFocusTraversalPolicy
Параметры:
aComponent - Component, чья пригодность в качестве владельца фокуса проверяется
Возвращает:
true, если aComponent является допустимым выбором для владельца фокуса; в противном случае false
См. также:
  • Component.isVisible()
  • Component.isDisplayable()
  • Component.isEnabled()
  • Component.isFocusable()
  • ComboBoxUI.isFocusTraversable(javax.swing.JComboBox<?>)
  • JComponent.getInputMap(int)
  • DefaultFocusTraversalPolicy.accept(java.awt.Component)

© 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/javax/swing/LayoutFocusTraversalPolicy.html

Spec-Zone.ru

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