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

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

Since:: JavaFX 2.0
See Also:: SelectionModel, MultipleSelectionModel, SelectionMode

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

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

selectedIndex, selectedItem

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

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

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

Модификатор и тип	Метод	Описание
`void`	`clearAndSelect(int index)`	В SingleSelectionModel этот метод функционально эквивалентен вызову `select(index)`, так как разрешен только один выбор за раз.
`void`	`clearSelection(int index)`	Очищает выбор заданного индекса, если он выбран в данный момент.
`protected abstract int`	`getItemCount()`	Возвращает количество элементов, доступных для модели выбора.
`protected abstract T`	`getModelItem(int index)`	Возвращает элемент модели данных, связанный с определённым индексом.
`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

clearSelection, getSelectedIndex, getSelectedItem, isEmpty, 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(int index)

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

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

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.