Класс 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

Модификатор и тип	Метод	Описание
`Component`	`getInitialComponent(JInternalFrame frame)`	Возвращает компонент, который должен получить фокус при первом выборе JInternalFrame.

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

getInitialComponent

Модификатор и тип	Метод	Описание
`Component`	`getInitialComponent(Window window)`	Возвращает компонент, который должен получить фокус при первом отображении Window.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

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.