Класс 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
См. также:: SelectionModel, SelectionMode

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

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

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

selectedIndex, selectedItem

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

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

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

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

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

MultipleSelectionModel

public MultipleSelectionModel()

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

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

setSelectionMode

public final void setSelectionMode(SelectionMode value)

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

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

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

getSelectionMode

public final SelectionMode getSelectionMode()

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

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

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

selectionModeProperty

public final ObjectProperty<SelectionMode> selectionModeProperty()

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

См. также:: 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.