Класс TableSelectionModel<T>

java.lang.Object

javafx.scene.control.SelectionModel<T>

javafx.scene.control.MultipleSelectionModel<T>

javafx.scene.control.TableSelectionModel<T>

Параметры типа:: T - Тип базовой модели данных для пользовательского интерфейса.

Прямые известные подклассы:: TableView.TableViewSelectionModel, TreeTableView.TreeTableViewSelectionModel

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

Абстрактный базовый класс для реализации MultipleSelectionModel, используемых в таблицах (в первую очередь в TableView и TreeTableView).

С тех пор:: JavaFX 8.0

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

Тип	Свойство	Описание
`final BooleanProperty`	`cellSelectionEnabled`	Логическое свойство, определяющее режим выбора в таблице (строки или ячейки).

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

selectionMode

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

selectedIndex, selectedItem

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

Конструктор	Описание
`TableSelectionModel()`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`final BooleanProperty`	`cellSelectionEnabledProperty()`	Логическое свойство, определяющее режим выбора в таблице (строки или ячейки).
`void`	`clearAndSelect(int row)`	Метод очищает любой предыдущий выбор перед установкой выбора на указанный индекс.
`abstract void`	`clearAndSelect(int row, TableColumnBase<T,?> column)`	Очищает весь выбор, а затем выбирает ячейку на пересечении указанной строки и столбца.
`void`	`clearSelection()`	Очищает модель выбора всех выбранных индексов.
`void`	`clearSelection(int index)`	Этот метод очистит выбор элемента с указанным индексом.
`abstract void`	`clearSelection(int row, TableColumnBase<T,?> column)`	Удаляет выбор из указанного положения строки/столбца (в индексах представления).
`protected abstract void`	`focus(int index)`	Фокусирует элемент с указанным индексом.
`protected abstract int`	`getFocusedIndex()`	Получает индекс фокусированного элемента.
`protected abstract int`	`getItemCount()`	Возвращает количество элементов в модели данных, которая лежит в основе элемента управления.
`protected abstract T`	`getModelItem(int index)`	Возвращает элемент с заданным индексом.
`ObservableList<Integer>`	`getSelectedIndices()`	Возвращает только для чтения ObservableList всех выбранных индексов.
`ObservableList<T>`	`getSelectedItems()`	Возвращает только для чтения ObservableList всех выбранных элементов.
`final boolean`	`isCellSelectionEnabled()`	Получает значение свойства `cellSelectionEnabled`.
`boolean`	`isEmpty()`	Этот метод доступен для проверки наличия выбранных индексов/элементов.
`boolean`	`isSelected(int index)`	Этот метод проверяет, выбран ли данный индекс в данном SelectionModel.
`abstract boolean`	`isSelected(int row, TableColumnBase<T,?> column)`	Вспомогательная функция, проверяющая, выбрана ли ячейка с заданным индексом строки и столбца в данном экземпляре таблицы.
`void`	`select(int row)`	Это выберет указанный индекс в модели выбора, предполагая, что индекс находится в допустимом диапазоне (т.е.
`abstract void`	`select(int row, TableColumnBase<T,?> column)`	Выбирает ячейку на пересечении заданной строки/столбца.
`void`	`select(T obj)`	Этот метод попытается выбрать индекс, содержащий данный объект.
`abstract void`	`selectAboveCell()`	Выбирает ячейку, расположенную непосредственно над текущей выбранной ячейкой.
`void`	`selectAll()`	Вспомогательный метод для выбора всех доступных индексов.
`abstract void`	`selectBelowCell()`	Выбирает ячейку, расположенную непосредственно под текущей выбранной ячейкой.
`void`	`selectFirst()`	Этот метод попытается выбрать первый индекс в элементе управления.
`void`	`selectIndices(int row, int... rows)`	Этот метод позволяет устанавливать один или несколько выборов одновременно.
`void`	`selectLast()`	Этот метод попытается выбрать последний индекс в элементе управления.
`abstract void`	`selectLeftCell()`	Выбирает ячейку слева от текущей выбранной ячейки.
`void`	`selectNext()`	Этот метод попытается выбрать индекс, непосредственно следующий за текущим фокусированным индексом.
`void`	`selectPrevious()`	Этот метод попытается выбрать индекс, непосредственно предшествующий текущему фокусированному индексу.
`abstract void`	`selectRange(int minRow, TableColumnBase<T,?> minColumn, int maxRow, TableColumnBase<T,?> maxColumn)`	Выбирает ячейки в диапазоне (minRow, minColumn) до (maxRow, maxColumn), включительно.
`abstract void`	`selectRightCell()`	Выбирает ячейку справа от текущей выбранной ячейки.
`final void`	`setCellSelectionEnabled(boolean value)`	Устанавливает значение свойства `cellSelectionEnabled`.

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

getSelectionMode, selectionModeProperty, selectRange, setSelectionMode

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

getSelectedIndex, getSelectedItem, selectedIndexProperty, selectedItemProperty, setSelectedIndex, setSelectedItem

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

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

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

cellSelectionEnabled

public final BooleanProperty cellSelectionEnabledProperty

Логическое свойство, используемое для представления, находится ли таблица в режиме выбора строк или ячеек. По умолчанию таблица находится в режиме выбора строк, что означает, что отдельные ячейки не могут быть выбраны. Установка cellSelectionEnabled в значение true позволяет выбирать ячейки (но не строки).

См. также:

isCellSelectionEnabled()
setCellSelectionEnabled(boolean)
cellSelectionEnabledProperty()

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

TableSelectionModel

public TableSelectionModel()

Конструктор для вызова подклассами.

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

isSelected

public abstract boolean isSelected(int row, TableColumnBase<T,?> column)

Вспомогательная функция, которая проверяет, выбрана ли заданная строка и столбец в текущем экземпляре этой таблицы. Если элемент управления таблицей находится в режиме «выбора ячеек» (где можно выбирать отдельные ячейки, а не целые строки), и если аргумент столбца равен null, этот метод должен возвращать true только в том случае, если все ячейки в заданной строке выбраны.

Параметры:: row - строка; column - столбец
Возвращает:: true, если заданная строка и столбец выбраны в данном экземпляре таблицы

select

public abstract void select(int row, TableColumnBase<T,?> column)

Выбирает ячейку на пересечении заданной строки/столбца. Если элемент управления таблицей находится в режиме «выбора ячеек» (где можно выбирать отдельные ячейки, а не целые строки), и если аргумент столбца равен null, этот метод должен выбрать все ячейки в заданной строке.

Параметры:: row - строка; column - столбец

clearAndSelect

public abstract void clearAndSelect(int row, TableColumnBase<T,?> column)

Очищает все выделения и затем выбирает ячейку на пересечении заданной строки/столбца. Если элемент управления таблицей находится в режиме «выбора ячеек» (где можно выбирать отдельные ячейки, а не целые строки), и если аргумент столбца равен null, этот метод должен выбрать все ячейки в заданной строке.

Параметры:: row - строка; column - столбец

clearSelection

public abstract void clearSelection(int row, TableColumnBase<T,?> column)

Удаляет выделение из указанной позиции строки/столбца (в индексах отображения). Если эта конкретная ячейка (или строка, если значение столбца равно -1) не выбрана, ничего не происходит. Если элемент управления таблицей находится в режиме «выбора ячеек» (где можно выбирать отдельные ячейки, а не целые строки), и если аргумент столбца равен null, этот метод должен снять выделение со всех ячеек в заданной строке.

Параметры:: row - строка; column - столбец

selectLeftCell

public abstract void selectLeftCell()

Выбирает ячейку слева от текущей выбранной ячейки.

selectRightCell

public abstract void selectRightCell()

Выбирает ячейку справа от текущей выбранной ячейки.

selectAboveCell

public abstract void selectAboveCell()

Выбирает ячейку непосредственно над текущей выбранной ячейкой.

selectBelowCell

public abstract void selectBelowCell()

Выбирает ячейку непосредственно под текущей выбранной ячейкой.

selectRange

public abstract void selectRange(int minRow, TableColumnBase<T,?> minColumn, int maxRow, TableColumnBase<T,?> maxColumn)

Выбирает ячейки в диапазоне (minRow, minColumn) до (maxRow, maxColumn), включительно.

Параметры:: minRow - minRow; minColumn - minColumn; maxRow - maxRow; maxColumn - maxColumn

cellSelectionEnabledProperty

public final BooleanProperty cellSelectionEnabledProperty()

Возвращает:

свойство cellSelectionEnabled

См. также:

isCellSelectionEnabled()
setCellSelectionEnabled(boolean)

setCellSelectionEnabled

public final void setCellSelectionEnabled(boolean value)

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

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

Параметры:

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

См. также:

isCellSelectionEnabled()
cellSelectionEnabledProperty()

isCellSelectionEnabled

public final boolean isCellSelectionEnabled()

Получает значение свойства cellSelectionEnabled.

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

Возвращает:

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

См. также:

setCellSelectionEnabled(boolean)
cellSelectionEnabledProperty()

getSelectedIndices

public ObservableList<Integer> getSelectedIndices()

Описание скопировано из класса: MultipleSelectionModel

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

Определено в:: getSelectedIndices в классе MultipleSelectionModel<T>
Возвращает:: список выбранных индексов

getSelectedItems

public ObservableList<T> getSelectedItems()

Описание скопировано из класса: MultipleSelectionModel

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

Определено в:: getSelectedItems в классе MultipleSelectionModel<T>
Возвращает:: список выбранных элементов

getItemCount

protected abstract int getItemCount()

Возвращает количество элементов в модели данных, которая лежит в основе элемента управления. Пример: модель выбора ListView, вероятно, вернет listView.getItems().size(). Действительный диапазон выбираемых индексов находится между 0 и значением, возвращаемым этим методом.

Возвращает:: количество элементов в модели данных, которая лежит в основе элемента управления

getModelItem

protected abstract T getModelItem(int index)

Возвращает элемент по заданному индексу. Пример, используя ListView, будет listView.getItems().get(index).

Параметры:: index - Индекс элемента, запрашиваемого из базовой модели данных.
Возвращает:: Возвращает null, если индекс находится вне границ, или элемент типа T, связанный с заданным индексом.

focus

protected abstract void focus(int index)

Фокусирует элемент по заданному индексу.

Параметры:: index - индекс фокусируемого элемента

getFocusedIndex

protected abstract int getFocusedIndex()

Получает индекс фокусированного элемента.

Возвращает:: индекс фокусированного элемента

clearAndSelect

public void clearAndSelect(int row)

Описание скопировано из класса: SelectionModel

Метод, который очищает любой выбор перед установкой выбора на заданный индекс. Цель этого метода — избежать необходимости вызова SelectionModel.clearSelection() сначала, что означает, что наблюдатели, которые следят за свойством selected index, не увидят, как индекс выбранного элемента временно устанавливается в -1.

Определено в:: clearAndSelect в классе SelectionModel<T>
Параметры:: row - Индекс, который должен быть единственным выбранным индексом в этой модели выбора.

select

public void select(int row)

Описание, скопированное из класса: SelectionModel

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

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

Если индекс уже выбран, он не будет выбран снова или снят с выбора. Однако, если реализовано множественное выделение, вызов select для уже выбранного индекса приведет к тому, что индекс станет новым выбранным индексом (как возвращается SelectionModel.getSelectedIndex().

Указано в:: select в классе SelectionModel<T>
Параметры:: row - Позиция элемента для выбора в модели выбора.

select

public void select(T obj)

Описание, скопированное из класса: SelectionModel

Этот метод попытается выбрать индекс, содержащий заданный объект. Он будет перебирать базовую модель данных, пока не найдет элемент, значение которого равно заданному объекту. На этом этапе он прекратит итерацию — это означает, что этот метод не будет выбирать несколько индексов.

Указано в:: select в классе SelectionModel<T>
Параметры:: obj - Объект, который нужно попытаться выбрать в базовой модели данных.

selectIndices

public void selectIndices(int row, int... rows)

Описание, скопированное из класса: MultipleSelectionModel

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

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

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

Указано в:: selectIndices в классе MultipleSelectionModel<T>
Параметры:: row - первый индекс для выбора; rows - ноль или более дополнительных индексов для выбора

selectAll

public void selectAll()

Описание, скопированное из класса: MultipleSelectionModel

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

Указано в:: selectAll в классе MultipleSelectionModel<T>

selectFirst

public void selectFirst()

Описание, скопированное из класса: MultipleSelectionModel

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

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

Указано в:: selectFirst в классе MultipleSelectionModel<T>

selectLast

public void selectLast()

Описание, скопированное из класса: MultipleSelectionModel

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

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

Указано в:: selectLast в классе MultipleSelectionModel<T>

clearSelection

public void clearSelection(int index)

Описание, скопированное из класса: SelectionModel

Этот метод очистит выбор элемента в заданном индексе. Если заданный индекс не выбран, ничего не произойдет.

Указано в:: clearSelection в классе SelectionModel<T>
Параметры:: index - выбранный элемент для снятия выбора.

clearSelection

public void clearSelection()

Описание, скопированное из класса: SelectionModel

Очищает модель выбора всех выбранных индексов.

Указано в:: clearSelection в классе SelectionModel<T>

isSelected

public boolean isSelected(int index)

Описание, скопированное из класса: SelectionModel

Этот метод проверяет, выбран ли заданный индекс в данной SelectionModel.

Указано в:: isSelected в классе SelectionModel<T>
Параметры:: index - индекс, который нужно проверить на текущий выбор.
Возвращает:: True, если заданный индекс выбран, false в противном случае.

isEmpty

public boolean isEmpty()

Описание, скопированное из класса: SelectionModel

Этот метод доступен для проверки наличия выбранных индексов/элементов. Он вернёт true, если выбранных элементов нет, и false, если они есть.

Указано в:: isEmpty в классе SelectionModel<T>
Возвращает:: Вернёт true, если выбранных элементов нет, и false, если они есть.

selectPrevious

public void selectPrevious()

Описание, скопированное из класса: SelectionModel

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

Вызов этого метода будет успешным только при выполнении следующих условий:

В настоящее время существует ведущий/фокусный индекс.
Индекс ввода/фокуса не является первым индексом в элементе управления.
Предыдущий индекс ещё не выбран.

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

Указано в:: selectPrevious в классе SelectionModel<T>

selectNext

public void selectNext()

Описание, скопированное из класса: SelectionModel

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

Вызов этого метода будет успешным только при выполнении следующих условий:

В настоящее время существует ведущий/фокусный индекс.
Индекс ввода/фокуса не является последним индексом в элементе управления.
Следующий индекс ещё не выбран.

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

Указано в:: selectNext в классе 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.