Класс ContainerOrderFocusTraversalPolicy

java.lang.Object

java.awt.FocusTraversalPolicy

java.awt.ContainerOrderFocusTraversalPolicy

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

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

public class ContainerOrderFocusTraversalPolicy extends FocusTraversalPolicy implements Serializable

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

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

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

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

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

1.4

См. также:

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

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

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

Модификатор и тип	Метод	Описание
`protected boolean`	`accept(Component aComponent)`	Определяет, подходит ли компонент на роль нового владельца фокуса.
`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()`	Возвращает признак того, что этот ContainerOrderFocusTraversalPolicy неявно передаёт фокус вниз по циклу.
`Component`	`getLastComponent(Container aContainer)`	Возвращает последний компонент в цикле обхода.
`void`	`setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)`	Задаёт, будет ли этот ContainerOrderFocusTraversalPolicy неявно передавать фокус вниз по циклу.

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

getInitialComponent

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

Если 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/ContainerOrderFocusTraversalPolicy.html