Класс ContainerOrderFocusTraversalPolicy

Все реализованные интерфейсы:
Serializable
Прямые известные подклассы:
DefaultFocusTraversalPolicy
public class ContainerOrderFocusTraversalPolicy
extends FocusTraversalPolicy
implements Serializable

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

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

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

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

C момента:
1.4
См. также:
Container.getComponents(), Сериализованная форма

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

Конструктор Описание
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()

Методы

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, 2020, 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/11/docs/api/java.desktop/java/awt/ContainerOrderFocusTraversalPolicy.html

Spec-Zone .ru
спецификации, руководства, описания, API