Класс MultipleSelectionModel<T>

java.lang.Object

javafx.scene.control.SelectionModel<T>

javafx.scene.control.MultipleSelectionModel<T>

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

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

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

Абстрактный класс, расширяющий SelectionModel, чтобы добавить API для поддержки множественного выбора.

С момента:

JavaFX 2.0

См. также:

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

Тип	Свойство	Описание
`final ObjectProperty<SelectionMode>`	`selectionMode`	Указывает режим выбора, который следует использовать в этой модели выбора.

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

selectedIndex, selectedItem

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

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

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

Модификатор и тип	Метод	Описание
`abstract ObservableList<Integer>`	`getSelectedIndices()`	Возвращает только для чтения ObservableList всех выбранных индексов.
`abstract ObservableList<T>`	`getSelectedItems()`	Возвращает только для чтения ObservableList всех выбранных элементов.
`final SelectionMode`	`getSelectionMode()`	Получает значение свойства `selectionMode`.
`abstract void`	`selectAll()`	Удобный метод для выбора всех доступных индексов.
`abstract void`	`selectFirst()`	Этот метод попытается выбрать первый индекс в элементе управления.
`abstract void`	`selectIndices(int index, int... indices)`	Этот метод позволяет одновременно устанавливать один или несколько выборов.
`final ObjectProperty<SelectionMode>`	`selectionModeProperty()`	Указывает режим выбора, который следует использовать в этой модели выбора.
`abstract void`	`selectLast()`	Этот метод попытается выбрать последний индекс в элементе управления.
`void`	`selectRange(int start, int end)`	Выбирает все индексы от заданного начального индекса до элемента перед заданным конечным индексом.
`final void`	`setSelectionMode(SelectionMode value)`	Устанавливает значение свойства `selectionMode`.

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

clearAndSelect, clearSelection, clearSelection, getSelectedIndex, getSelectedItem, isEmpty, isSelected, select, select, selectedIndexProperty, selectedItemProperty, selectNext, selectPrevious, setSelectedIndex, setSelectedItem

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

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

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

selectionMode

public final ObjectProperty<SelectionMode> selectionModeProperty

Указывает режим выбора, используемый в этой модели выбора. Режим выбора определяет, сколько элементов в основной модели данных можно выбрать одновременно.

По умолчанию режим выбора — SelectionMode.SINGLE.

См. также:

getSelectionMode()
setSelectionMode(SelectionMode)
selectionModeProperty()

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

MultipleSelectionModel

public MultipleSelectionModel()

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

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

setSelectionMode

public final void setSelectionMode(SelectionMode value)

Устанавливает значение свойства selectionMode.

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

По умолчанию режим выбора — SelectionMode.SINGLE.

Параметры:

value - значение свойства selectionMode

См. также:

getSelectionMode()
selectionModeProperty()

getSelectionMode

public final SelectionMode getSelectionMode()

Возвращает значение свойства selectionMode.

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

По умолчанию режим выбора — SelectionMode.SINGLE.

Возвращает:

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

См. также:

setSelectionMode(SelectionMode)
selectionModeProperty()

selectionModeProperty

public final ObjectProperty<SelectionMode> selectionModeProperty()

По умолчанию режим выбора — SelectionMode.SINGLE.

Возвращает:

свойство selectionMode

См. также:

getSelectionMode()
setSelectionMode(SelectionMode)

getSelectedIndices

public abstract ObservableList<Integer> getSelectedIndices()

Возвращает только для чтения ObservableList всех выбранных индексов. ObservableList будет обновляться моделью выбора для отражения любых изменений в выборе. Это можно наблюдать, добавив ListChangeListener в возвращаемый ObservableList.

Возвращает:: список выбранных индексов

getSelectedItems

public abstract ObservableList<T> getSelectedItems()

Возвращает только для чтения ObservableList всех выбранных элементов. ObservableList будет обновляться моделью выбора для отражения любых изменений в выборе. Это можно наблюдать, добавив ListChangeListener в возвращаемый ObservableList.

Возвращает:: список выбранных элементов

selectIndices

public abstract void selectIndices(int index, int... indices)

Этот метод позволяет установить один или несколько выборов одновременно. Он проигнорирует любые значения, которые не попадают в допустимый диапазон (т. е. больше или равно нулю и меньше общего количества элементов в основной модели данных). Любые дубликаты индексов будут проигнорированы.

Если в этой модели уже выбран один или несколько индексов, вызов этого метода не очистит эти выборки — для этого необходимо сначала вызвать clearSelection.

Последнее допустимое значение станет выбранным индексом/выбранным элементом.

Параметры:: index - первый индекс для выбора; indices - ноль или более дополнительных индексов для выбора

selectRange

public void selectRange(int start, int end)

Выбирает все индексы от заданного начального индекса до элемента перед заданным конечным индексом. Это означает, что выбор включает начальный индекс и исключает конечный индекс. Этот метод будет работать независимо от того, является ли start < end или start > end: единственной постоянной является то, что индекс перед заданным конечным индексом станет выбранным индексом.

Параметры:: start - первый индекс для выбора - этот индекс будет выбран.; end - последний индекс выбора - этот индекс не будет выбран.

selectAll

public abstract void selectAll()

Метод для удобства выбора всех доступных индексов.

selectFirst

public abstract void selectFirst()

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

Если первый индекс уже выбран, вызов этого метода не даст никакого результата и не произойдёт событие выбора.

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

selectLast

public abstract void selectLast()

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

Если последний индекс уже выбран, вызов этого метода не даст никакого результата и не произойдёт событие выбора.

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

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