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

Модификатор и тип	Метод	Описание
`Component`	`getInitialComponent(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, либо до истечения заданного промежутка реального времени.

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

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.