Класс SingleSelectionModel<T>

java.lang.Object

javafx.scene.control.SelectionModel<T>

javafx.scene.control.SingleSelectionModel<T>

Type Parameters:: T - Тип элемента, содержащегося в элементе управления, который можно выбрать.

public abstract class SingleSelectionModel<T> extends SelectionModel<T>

Модель выбора, которая обеспечивает требование, что в любой момент времени может быть выбран только один индекс. Этот класс существует для элементов управления, которые позволяют использовать настраиваемые модели выбора, но не допускают множественного выбора. Хорошим примером является элемент управления ChoiceBox. Напротив, большинство других элементов управления (ListView, TreeView, TableView и т.д.) требуют реализаций MultipleSelectionModel (хотя MultipleSelectionModel по-прежнему позволяет установить одиночный выбор с помощью свойства selectionMode).

Since:

JavaFX 2.0

See Also:

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

Свойства, объявленные в классе javafx.scene.control.SelectionModel

selectedIndex, selectedItem

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

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

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

Модификатор и тип	Метод	Описание
`void`	`clearAndSelect(int index)`	В SingleSelectionModel этот метод функционально эквивалентен вызову `select(index)`, так как одновременно разрешён только один выбор.
`void`	`clearSelection()`	Очищает модель выбора всех выбранных индексов.
`void`	`clearSelection(int index)`	Очищает выбор заданного индекса, если он в настоящее время выбран.
`protected abstract int`	`getItemCount()`	Получает количество элементов, доступных для модели выбора.
`protected abstract T`	`getModelItem(int index)`	Получает элемент данных модели, связанный с определённым индексом.
`boolean`	`isEmpty()`	Этот метод доступен для проверки наличия выбранных индексов/элементов.
`boolean`	`isSelected(int index)`	Этот метод вернёт true, если данный индекс является текущим выбранным индексом в этой SingleSelectionModel.
`void`	`select(int index)`	Выбирает заданный индекс.
`void`	`select(T obj)`	Выбирает индекс для первого вхождения заданного объекта в базовой модели данных.
`void`	`selectFirst()`	Выбирает первый индекс.
`void`	`selectLast()`	Выбирает последний индекс.
`void`	`selectNext()`	Выбирает следующий индекс.
`void`	`selectPrevious()`	Выбирает предыдущий индекс.

Методы, объявленные в классе javafx.scene.control.SelectionModel

getSelectedIndex, getSelectedItem, selectedIndexProperty, selectedItemProperty, setSelectedIndex, setSelectedItem

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

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

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

SingleSelectionModel

public SingleSelectionModel()

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

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

clearSelection

public void clearSelection()

Очищает модель выделения всех выбранных индексов.

Определено в:: clearSelection в классе SelectionModel<T>

clearSelection

public void clearSelection(int index)

Очищает выделение заданного индекса, если он выбран в данный момент.

Определено в:: clearSelection в классе SelectionModel<T>
Параметры:: index - Выбранный элемент для снятия выделения.

isEmpty

public boolean isEmpty()

Этот метод предназначен для проверки наличия выбранных индексов/элементов. Он вернёт true, если выбранных элементов нет, и false, если они есть.

Определено в:: isEmpty в классе SelectionModel<T>
Возвращает:: Вернет true, если выбранных элементов нет, и false, если они есть.

isSelected

public boolean isSelected(int index)

Этот метод вернет true, если заданный индекс является текущим выбранным индексом в этом SingleSelectionModel.

Определено в:: isSelected в классе SelectionModel<T>
Параметры:: index - Индекс для проверки, выбран ли он в данный момент.
Возвращает:: True, если заданный индекс выбран, иначе false.

clearAndSelect

public void clearAndSelect(int index)

В SingleSelectionModel этот метод функционально эквивалентен вызову select(index), так как одновременно разрешено только одно выделение.

Определено в:: clearAndSelect в классе SelectionModel<T>
Параметры:: index - Индекс, который должен быть единственным выбранным индексом в этой модели выделения.

select

public void select(T obj)

Выбирает индекс для первого экземпляра заданного объекта в базовой модели данных. Поскольку SingleSelectionModel может поддерживать только один выделенный индекс за раз, это также приводит к снятию выделения с любого ранее выбранного индекса.

Определено в:: select в классе SelectionModel<T>
Параметры:: obj - Объект, который нужно попытаться выбрать в базовой модели данных.

select

public void select(int index)

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

Определено в:: select в классе SelectionModel<T>
Параметры:: index - Позиция элемента для выбора в модели выделения.

selectPrevious

public void selectPrevious()

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

Определено в:: selectPrevious в классе SelectionModel<T>

selectNext

public void selectNext()

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

Определено в:: selectNext в классе SelectionModel<T>

selectFirst

public void selectFirst()

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

Определено в:: selectFirst в классе SelectionModel<T>

selectLast

public void selectLast()

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

Определено в:: selectLast в классе SelectionModel<T>

getModelItem

protected abstract T getModelItem(int index)

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

Параметры:: index - Позиция элемента в базовой модели данных.
Возвращает:: Элемент, который находится по заданному индексу.

getItemCount

protected abstract int getItemCount()

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

Возвращает:: Число, большее или равное 0.

© 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.