Класс SortingFocusTraversalPolicy

Прямые известные подклассы:
LayoutFocusTraversalPolicy
public class SortingFocusTraversalPolicy
extends InternalFrameFocusTraversalPolicy

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

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

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

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

С тех пор, как:
1.4
См. также:
Comparator

Конструкторы

Модификатор Конструктор Описание
protected SortingFocusTraversalPolicy()

Создает SortingFocusTraversalPolicy без компаратора.
SortingFocusTraversalPolicy​(Comparator<? super Component> comparator)

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

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

Если 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
См. также:
getFirstComponent(java.awt.Container)

setImplicitDownCycleTraversal

public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)

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

Параметры:
implicitDownCycleTraversal - неявно ли SortingFocusTraversalPolicy передает фокус по циклу вниз
См. также:
getImplicitDownCycleTraversal(), getFirstComponent(java.awt.Container)

getImplicitDownCycleTraversal

public boolean getImplicitDownCycleTraversal()

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

Возвращает:
неявно ли SortingFocusTraversalPolicy передает фокус по циклу вниз
См. также:
setImplicitDownCycleTraversal(boolean), getFirstComponent(java.awt.Container)

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, 2020, 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/11/docs/api/java.desktop/javax/swing/SortingFocusTraversalPolicy.html

Spec-Zone .ru
спецификации, руководства, описания, API