Класс ContainerOrderFocusTraversalPolicy

public class ContainerOrderFocusTraversalPolicy
extends FocusTraversalPolicy
implements Serializable

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

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

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

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

Конструкторы

ContainerOrderFocusTraversalPolicy

public ContainerOrderFocusTraversalPolicy()

Методы

getComponentAfter

public Component getComponentAfter(Container aContainer,
                                   Component aComponent)

Указано в:

getComponentAfter в классе FocusTraversalPolicy

Параметры:

aContainer - корень цикла фокуса для aComponent или поставщик политики перехода фокуса

aComponent - (возможно, косвенный) дочерний элемент aContainer или сам aContainer

Возвращает:

компонент Component, который должен получить фокус после aComponent, или null, если подходящий компонент не найден

Выбрасывает:

IllegalArgumentException - если aContainer не является корнем цикла фокуса для aComponent или поставщиком политики перехода фокуса, или если aContainer или aComponent равны null

getComponentBefore

public Component getComponentBefore(Container aContainer,
                                    Component aComponent)

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

Указано в:

getComponentBefore в классе FocusTraversalPolicy

Параметры:

aContainer - корень цикла фокуса для aComponent или поставщик политики перехода фокуса

aComponent - (возможно, косвенный) дочерний элемент aContainer или сам aContainer

Возвращает:

компонент Component, который должен получить фокус перед aComponent, или null, если подходящий компонент не найден

Выбрасывает:

IllegalArgumentException - если aContainer не является корнем цикла фокуса для aComponent или поставщиком политики перехода фокуса, или если aContainer или aComponent равны null

getFirstComponent

public Component getFirstComponent(Container aContainer)

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

Указано в:

getFirstComponent в классе FocusTraversalPolicy

Параметры:

aContainer - корень цикла фокуса или поставщик политики перехода фокуса, первый компонент которого должен быть возвращен

Возвращает:

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

Выбрасывает:

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

getLastComponent

public Component getLastComponent(Container aContainer)

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

Указано в:

getLastComponent в классе FocusTraversalPolicy

Параметры:

aContainer - корень цикла фокуса или поставщик политики перехода фокуса, последний компонент которого должен быть возвращен

Возвращает:

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

Выбрасывает:

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

getDefaultComponent

public Component getDefaultComponent(Container aContainer)

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

Указано в:

getDefaultComponent в классе FocusTraversalPolicy

Параметры:

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

Возвращает:

компонент Component по умолчанию в цикле перехода 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)

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

Параметры:

aComponent - компонент Component, чья пригодность в качестве владельца фокуса проверяется

Возвращает:

true если aComponent видимый, отображаемый, активный и фокусируемый; false в противном случае