Класс SortingFocusTraversalPolicy

javax.swing.SortingFocusTraversalPolicy

Непосредственно известные подклассы:: LayoutFocusTraversalPolicy

public class SortingFocusTraversalPolicy extends InternalFrameFocusTraversalPolicy

Политика обхода фокуса, определяющая порядок обхода путем сортировки компонентов цикла обхода фокуса на основе заданного компаратора. Части иерархии компонентов, которые не видны и не отображаются, не включаются.

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

По умолчанию методы этого класса возвращают компонент только в том случае, если он видим, отображается, включен и может получать фокус. Подклассы могут изменить это поведение, переопределив метод accept.

Эта политика учитывает поставщиков политик обхода фокуса. При поиске первого/последнего/следующего/предыдущего компонента, если встречается поставщик политики обхода фокуса, для выполнения поиска используется его политика обхода фокуса.

Начиная с версии:

1.4

См. также:

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

SortingFocusTraversalPolicy()

SortingFocusTraversalPolicy(Comparator<? super Component> comparator)

Модификатор	Конструктор	Описание
`protected`	Создает SortingFocusTraversalPolicy без компаратора.
	Создает SortingFocusTraversalPolicy с указанным компаратором.

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

Модификатор и тип	Метод	Описание
`protected boolean`	`accept(Component aComponent)`	Определяет, является ли компонент допустимым кандидатом на роль нового владельца фокуса.
`protected Comparator<? super Component>`	`getComparator()`	Возвращает компаратор, который будет использоваться для сортировки компонентов в цикле обхода фокуса.
`Component`	`getComponentAfter(Container aContainer, Component aComponent)`	Возвращает компонент, который должен получить фокус после aComponent. aContainer должен быть корнем цикла обхода фокуса для aComponent или поставщиком политики обхода фокуса.
`Component`	`getComponentBefore(Container aContainer, Component aComponent)`	Возвращает компонент, который должен получить фокус перед aComponent. aContainer должен быть корнем цикла обхода фокуса для aComponent или поставщиком политики обхода фокуса.
`Component`	`getDefaultComponent(Container aContainer)`	Возвращает компонент, который должен получить фокус по умолчанию.
`Component`	`getFirstComponent(Container aContainer)`	Возвращает первый компонент в цикле обхода.
`boolean`	`getImplicitDownCycleTraversal()`	Возвращает, неявно ли эта SortingFocusTraversalPolicy передает фокус вниз по циклу.
`Component`	`getLastComponent(Container aContainer)`	Возвращает последний компонент в цикле обхода.
`protected void`	`setComparator(Comparator<? super Component> comparator)`	Задает компаратор, который будет использоваться для сортировки компонентов в цикле обхода фокуса.
`void`	`setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)`	Задает, должна ли эта SortingFocusTraversalPolicy неявно передавать фокус вниз по циклу.

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

getInitialComponent

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

getInitialComponent

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

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

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

SortingFocusTraversalPolicy

protected SortingFocusTraversalPolicy()

Создает SortingFocusTraversalPolicy без компаратора. Подклассы должны задать компаратор с помощью setComparator до установки этой FocusTraversalPolicy для корня цикла обхода фокуса или KeyboardFocusManager.

SortingFocusTraversalPolicy

public SortingFocusTraversalPolicy(Comparator<? super Component> comparator)

Создает SortingFocusTraversalPolicy с указанным компаратором.

Параметры:: comparator — Comparator, по которому выполняется сортировка

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

getComponentAfter

public Component getComponentAfter(Container aContainer, Component aComponent)

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

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

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

getComponentBefore

public Component getComponentBefore(Container aContainer, Component aComponent)

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

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

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

getFirstComponent

public Component getFirstComponent(Container aContainer)

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

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

getLastComponent

public Component getLastComponent(Container aContainer)

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

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

getDefaultComponent

public Component getDefaultComponent(Container aContainer)

Возвращает компонент, который должен получить фокус по умолчанию. Этот компонент первым получит фокус при переходе вниз в новый цикл обхода фокуса с корнем aContainer. Реализация этого метода по умолчанию возвращает тот же компонент, что и getFirstComponent.

Определено в:

getDefaultComponent в классе FocusTraversalPolicy

Параметры:

aContainer — корень цикла обхода фокуса для aComponent или поставщик политики обхода фокуса, компонент по умолчанию которого нужно вернуть

Возвращает:

компонент по умолчанию в цикле обхода aContainer или null, если подходящий компонент не найден

Вызывает исключение:

IllegalArgumentException — если aContainer имеет значение null

См. также:

setImplicitDownCycleTraversal

public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)

Задает, должна ли эта SortingFocusTraversalPolicy неявно передавать фокус вниз по циклу. Если true, при обычном обходе фокуса компонентом, следующим после корня цикла обхода фокуса, будет компонент корня цикла обхода фокуса, получающий фокус по умолчанию. Если false, вместо этого будет выбран следующий компонент в цикле обхода фокуса с указанным корнем цикла обхода фокуса. Значение этого свойства по умолчанию — true.

Параметры:

implicitDownCycleTraversal — должна ли эта SortingFocusTraversalPolicy неявно передавать фокус вниз по циклу

См. также:

getImplicitDownCycleTraversal

public boolean getImplicitDownCycleTraversal()

Возвращает, неявно ли эта SortingFocusTraversalPolicy передает фокус вниз по циклу. Если true, при обычном обходе фокуса компонентом, следующим после корня цикла обхода фокуса, будет компонент корня цикла обхода фокуса, получающий фокус по умолчанию. Если false, вместо этого будет выбран следующий компонент в цикле обхода фокуса с указанным корнем цикла обхода фокуса.

Возвращает:

неявно ли эта SortingFocusTraversalPolicy передает фокус вниз по циклу

См. также:

setComparator

protected void setComparator(Comparator<? super Component> comparator)

Задает компаратор, который будет использоваться для сортировки компонентов в цикле обхода фокуса.

Параметры:: comparator — компаратор, который будет использоваться для сортировки

getComparator

protected Comparator<? super Component> getComparator()

Возвращает компаратор, который будет использоваться для сортировки компонентов в цикле обхода фокуса.

Возвращает:: компаратор, который будет использоваться для сортировки

accept

protected boolean accept(Component aComponent)

Определяет, является ли компонент допустимым кандидатом на роль нового владельца фокуса. По умолчанию этот метод принимает компонент тогда и только тогда, когда он видим, отображается, включен и может получать фокус.

Параметры:: aComponent — компонент, пригодность которого в качестве владельца фокуса проверяется
Возвращает:: true, если aComponent видим, отображается, включен и может получать фокус; false в противном случае

© 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/SortingFocusTraversalPolicy.html