- java.lang.Object
-
- javafx.scene.control.SelectionModel<T>
-
- javafx.scene.control.SingleSelectionModel<T>
-
- Параметры типа:
-
T- Тип элемента, содержащегося в элементе управления, который может быть выбран.
public abstract class SingleSelectionModel<T> extends SelectionModel<T>
Модель выбора, которая требует, чтобы в любой момент времени был выбран только один индекс. Этот класс существует для элементов управления, которые позволяют подключать модели выбора, но не допускают множественного выбора. Хороший пример — элемент управленияChoiceBox. Напротив, большинство других элементов управления (ListView,TreeView,TableViewи т. д.) требуют реализацииMultipleSelectionModel(хотя MultipleSelectionModel все же позволяет установить одиночный выбор через свойствоselectionMode).- С момента:
- JavaFX 2.0
- См. также:
-
SelectionModel,MultipleSelectionModel,SelectionMode
-
Резюме свойств
-
Свойства, унаследованные от класса javafx.scene.control.SelectionModel
selectedIndex, selectedItem
-
-
Краткое описание конструкторов
Конструкторы Конструктор Описание SingleSelectionModel()Создает экземпляр SingleSelectionModel по умолчанию.
-
Краткое описание методов
Все методыМетоды экземпляраАбстрактные методыКонкретные методы Модификатор и тип Метод Описание voidclearAndSelect(int index)В SingleSelectionModel этот метод функционально эквивалентен вызовуselect(index), так как разрешен только один выбор за раз.voidclearSelection()Очищает модель выбора всех выбранных индексов.voidclearSelection(int index)Очищает выбор данного индекса, если он в настоящее время выбран.protected abstract intgetItemCount()Возвращает количество элементов, доступных для модели выбора.protected abstract TgetModelItem(int index)Возвращает элемент модели данных, связанный с определенным индексом.booleanisEmpty()Этот метод доступен для проверки наличия выбранных индексов/элементов.booleanisSelected(int index)Этот метод вернет true, если данный индекс является текущим выбранным индексом в этой SingleSelectionModel.voidselect(int index)Выбирает данный индекс.voidselect(T obj)Выбирает индекс первого вхождения заданного объекта в базовой модели данных.voidselectFirst()Выбирает первый индекс.voidselectLast()Выбирает последний индекс.voidselectNext()Выбирает следующий индекс.voidselectPrevious()Выбирает предыдущий индекс.-
Методы, унаследованные от класса javafx.scene.control.SelectionModel
getSelectedIndex, getSelectedItem, selectedIndexProperty, selectedItemProperty, setSelectedIndex, setSelectedItem
-
-
Подробное описание конструкторов
-
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.