Класс 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.
`Component`	`getComponentBefore(Container aContainer, Component aComponent)`	Возвращает компонент, который должен получить фокус перед 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 передает фокус по циклу.

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

getInitialComponent

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

getInitialComponent

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

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

getComponentAfter

public Component getComponentAfter(Container aContainer, Component aComponent)

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

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

Если 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/SortingFocusTraversalPolicy.html