Класс FocusTraversalPolicy

public abstract class FocusTraversalPolicy
extends Object

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

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

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

Для получения дополнительной информации см. Как использовать подсистему фокуса, раздел в Руководстве Java, и Спецификацию фокуса.

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

FocusTraversalPolicy

public FocusTraversalPolicy()

Методы

getComponentAfter

public abstract Component getComponentAfter(Container aContainer,
                                            Component aComponent)

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

getComponentBefore

public abstract Component getComponentBefore(Container aContainer,
                                             Component aComponent)

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

getFirstComponent

public abstract Component getFirstComponent(Container aContainer)

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

Параметры:

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

Возвращает:

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

Исключения:

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

getLastComponent

public abstract Component getLastComponent(Container aContainer)

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

Параметры:

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

Возвращает:

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

Исключения:

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

getDefaultComponent

public abstract Component getDefaultComponent(Container aContainer)

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

Параметры:

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

Возвращает:

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

Исключения:

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

getInitialComponent

public Component getInitialComponent(Window window)

Возвращает компонент, который должен получить фокус, когда окно становится видимым в первый раз. После того, как окно было сделано видимым вызовом show() или setVisible(true), начальный компонент больше не будет использоваться. Вместо этого, если окно теряет и затем снова получает фокус, или становится невидимым или недоступным, а затем снова видимым и доступным, последний сфокусированный компонент окна станет владельцем фокуса. Стандартная реализация этого метода возвращает стандартный компонент.

Параметры:

window - окно, начальный компонент которого требуется вернуть

Возвращает:

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

Исключения:

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

См. также:

getDefaultComponent(java.awt.Container), Window.getMostRecentFocusOwner()