Класс ContainerOrderFocusTraversalPolicy

java.lang.Object

java.awt.FocusTraversalPolicy

java.awt.ContainerOrderFocusTraversalPolicy

Все реализуемые интерфейсы:: Serializable

Прямые известные подклассы:: DefaultFocusTraversalPolicy

public class ContainerOrderFocusTraversalPolicy extends FocusTraversalPolicy implements Serializable

Политика FocusTraversalPolicy, определяющая порядок обхода на основе порядка дочерних компонентов в контейнере. Из определенной корневой точки цикла фокуса политика выполняет предварительный обход иерархии компонентов и обходит дочерние элементы контейнера в соответствии с порядком массива, возвращаемого методом Container.getComponents(). Части иерархии, которые не видны и не отображаются, не будут просматриваться.

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

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

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

С:

1.4

См. также:

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

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

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

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

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

getInitialComponent

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

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

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

ContainerOrderFocusTraversalPolicy

public ContainerOrderFocusTraversalPolicy()

Создаёт ContainerOrderFocusTraversalPolicy.

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

getComponentAfter

public Component getComponentAfter(Container aContainer, Component aComponent)

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

По умолчанию, ContainerOrderFocusTraversalPolicy неявно передает фокус по циклу вниз. То есть, во время обычного перемещения фокуса вперёд, компонент, перемещаемый после корневого элемента цикла фокуса, будет по умолчанию компонентом корневого элемента цикла фокуса. Это поведение можно отключить, используя метод 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 или поставщиком политики перемещения фокуса.

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

getFirstComponent

public Component getFirstComponent(Container aContainer)

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

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

getLastComponent

public Component getLastComponent(Container aContainer)

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

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

getDefaultComponent

public Component getDefaultComponent(Container aContainer)

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

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

getDefaultComponent в классе FocusTraversalPolicy

Параметры:

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

Возвращает:

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

Исключение:

IllegalArgumentException - если aContainer равен null

См. также:

setImplicitDownCycleTraversal

public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)

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

Параметры:

implicitDownCycleTraversal - неявно ли ContainerOrderFocusTraversalPolicy переносит фокус по циклу вниз

См. также:

getImplicitDownCycleTraversal

public boolean getImplicitDownCycleTraversal()

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

Возвращает:

неявно ли ContainerOrderFocusTraversalPolicy переносит фокус по циклу вниз

См. также:

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/java/awt/ContainerOrderFocusTraversalPolicy.html