Класс 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.