Класс FocusTraversalPolicy

java.lang.Object

java.awt.FocusTraversalPolicy

Прямые известные подклассы:: ContainerOrderFocusTraversalPolicy, InternalFrameFocusTraversalPolicy

public abstract class FocusTraversalPolicy extends Object

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

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

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

Дополнительную информацию см. в разделе Использование подсистемы фокуса Учебника по Java и в спецификации фокуса.

Начиная с:

1.4

См. также:

Краткое описание конструкторов

FocusTraversalPolicy()

Модификатор	Конструктор	Описание
`protected`	Создает `FocusTraversalPolicy`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract Component`	`getComponentAfter(Container aContainer, Component aComponent)`	Возвращает компонент, которому следует передать фокус после aComponent. aContainer должен быть корнем цикла перемещения фокуса для aComponent или поставщиком политики перемещения фокуса.
`abstract Component`	`getComponentBefore(Container aContainer, Component aComponent)`	Возвращает компонент, которому следует передать фокус перед aComponent. aContainer должен быть корнем цикла перемещения фокуса для aComponent или поставщиком политики перемещения фокуса.
`abstract Component`	`getDefaultComponent(Container aContainer)`	Возвращает компонент, на который следует установить фокус по умолчанию.
`abstract Component`	`getFirstComponent(Container aContainer)`	Возвращает первый компонент в цикле обхода.
`Component`	`getInitialComponent(Window window)`	Возвращает компонент, которому следует передать фокус при первом отображении окна.
`abstract Component`	`getLastComponent(Container aContainer)`	Возвращает последний компонент в цикле обхода.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо истечения заданного интервала реального времени.

Подробное описание конструкторов

FocusTraversalPolicy

protected FocusTraversalPolicy()

Создает 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

См. также:

© 1993, 2025, 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.