Класс FocusModel<T>

java.lang.Object

fx.scene.control.FocusModel<T>

Параметры типа:: T - тип фокусируемого элемента

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

public abstract class FocusModel<T> extends Object

Абстрактный базовый класс для реализации FocusModel.

С момента:: JavaFX 2.0

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

Тип	Свойство	Описание
`final ReadOnlyIntegerProperty`	`focusedIndex`	Индекс текущего элемента в FocusModel, у которого есть фокус.
`final ReadOnlyObjectProperty<T>`	`focusedItem`	Текущий элемент в FocusModel, у которого есть фокус.

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

Конструктор	Описание
`FocusModel()`	Создаёт экземпляр FocusModel по умолчанию.

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

Модификатор и тип	Метод	Описание
`void`	`focus(int index)`	Приводит к тому, что элемент с данным индексом получает фокус.
`final ReadOnlyIntegerProperty`	`focusedIndexProperty()`	Индекс текущего элемента в FocusModel, у которого есть фокус.
`final ReadOnlyObjectProperty<T>`	`focusedItemProperty()`	Текущий элемент в FocusModel, у которого есть фокус.
`void`	`focusNext()`	Попытка присвоить фокус строке, следующей за текущей строкой с фокусом.
`void`	`focusPrevious()`	Попытка присвоить фокус строке, предшествующей текущей строке с фокусом.
`final int`	`getFocusedIndex()`	Получает значение свойства `focusedIndex`.
`final T`	`getFocusedItem()`	Получает значение свойства `focusedItem`.
`protected abstract int`	`getItemCount()`	Возвращает количество элементов в модели данных, которая лежит в основе элемента управления.
`protected abstract T`	`getModelItem(int index)`	Возвращает элемент по заданному индексу.
`boolean`	`isFocused(int index)`	Метод для удобства информирования, является ли данный индекс текущим фокусом в этом SelectionModel.

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

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

Подробности свойств

focusedIndex

public final ReadOnlyIntegerProperty focusedIndexProperty

Индекс текущего элемента в FocusModel, у которого есть фокус. Возможные значения: -1, только если элемент управления пустое. Если само средство управления не имеет фокуса, это свойство всё равно будет ссылаться на индекс строки, которая получит фокус клавиатуры, если бы средство управления имело фокус.

См. также:

focusedItem

public final ReadOnlyObjectProperty<T> focusedItemProperty

Текущий элемент в FocusModel, у которого есть фокус. Возможные значения: null, только если элемент управления пустое. Если само средство управления не имеет фокуса, это свойство всё равно будет ссылаться на элемент, который получит фокус клавиатуры, если бы средство управления имело фокус.

См. также:

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

FocusModel

public FocusModel()

Создает экземпляр FocusModel по умолчанию.

Подробности методов

focusedIndexProperty

public final ReadOnlyIntegerProperty focusedIndexProperty()

Возвращает:

свойство focusedIndex

См. также:

getFocusedIndex

public final int getFocusedIndex()

Получает значение свойства focusedIndex.

Описание свойства:

Возвращает:

значение свойства focusedIndex

См. также:

focusedItemProperty

public final ReadOnlyObjectProperty<T> focusedItemProperty()

Возвращает:

свойство focusedItem

См. также:

getFocusedItem

public final T getFocusedItem()

Получает значение свойства focusedItem.

Описание свойства:

Возвращает:

значение свойства focusedItem

См. также:

getItemCount

protected abstract int getItemCount()

Возвращает количество элементов в модели данных, на которой основано средство управления. Например, модель фокуса ListView, вероятно, вернет listView.getItems().size(). Допустимый диапазон индексов, на которые можно сфокусироваться, находится между 0 и значением, возвращаемым этим методом.

Возвращает:: количество элементов в модели данных, на которой основано средство управления

getModelItem

protected abstract T getModelItem(int index)

Возвращает элемент по заданному индексу. Пример с ListView: listView.getItems().get(index).

Параметры:: index - Индекс элемента, запрашиваемого из основной модели данных.
Возвращает:: Возвращает null, если индекс вне диапазона, или элемент типа T, связанный с данным индексом.

isFocused

public boolean isFocused(int index)

Удобный метод, позволяющий определить, имеет ли данный индекс фокус в данном SelectionModel. Функционально эквивалентен вызову

getFocusedIndex() == index

Параметры:: index - Индекс, который нужно проверить на наличие фокуса.
Возвращает:: True, если указанный индекс имеет фокус, false в противном случае.

focus

public void focus(int index)

Принудительно устанавливает фокус на элемент по заданному индексу. Это не изменяет текущий выбор. Обновляет свойства focusedItem и focusedIndex, таким образом, что focusedIndex = -1, если 0 <= index < model size.

Параметры:: index - Индекс элемента, которому нужно установить фокус.

focusPrevious

public void focusPrevious()

Пытается установить фокус на строку, предшествующую текущей. Если текущий владелец фокуса находится в первой строке или равен -1 (что означает, что текущего владельца фокуса нет), вызов этого метода не приведет к результату.

focusNext

public void focusNext()

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

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.