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

См. также:

getFirstComponent(java.awt.Container)

setImplicitDownCycleTraversal

public void setImplicitDownCycleTraversal(boolean implicitDownCycleTraversal)

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

Параметры:

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

См. также:

getImplicitDownCycleTraversal()
getFirstComponent(java.awt.Container)

getImplicitDownCycleTraversal

public boolean getImplicitDownCycleTraversal()

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

Возвращает:

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

См. также:

setImplicitDownCycleTraversal(boolean)
getFirstComponent(java.awt.Container)

accept

protected boolean accept(Component aComponent)

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

Параметры:: aComponent - компонент, пригодность которого в качестве владельца фокуса нужно проверить
Возвращает:: true если aComponent видим, отображаем, активен и фокусируемый; false в противном случае

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/ContainerOrderFocusTraversalPolicy.html