Класс 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, 2023, 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/21/docs/api/java.desktop/java/awt/ContainerOrderFocusTraversalPolicy.html