TableSelectionModel

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

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

Свойства
Тип	Свойство	Описание
`BooleanProperty`	`cellSelectionEnabled`	Логическое свойство, используемое для представления того, находятся ли таблица в режиме выбора строк или ячеек.

Свойства, унаследованные от класса javafx.scene.control.MultipleSelectionModel
selectionMode

Свойства, унаследованные от класса javafx.scene.control.SelectionModel
selectedIndex, selectedItem

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

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

TableSelectionModel()

Конструкторы
Конструктор	Описание
`TableSelectionModel()`

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

Все методыМетоды экземпляровАбстрактные методыКонкретные методы
Модификатор и тип	Метод	Описание
`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 всех выбранных элементов.
`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()`	Выбирает ячейку справа от текущей выбранной ячейки.
`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)

Подробное описание конструкторов
- 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 - минимальная строка
  
  minColumn - минимальный столбец
  
  maxRow - максимальная строка
  
  maxColumn - максимальный столбец
- cellSelectionEnabledProperty
```
public final BooleanProperty cellSelectionEnabledProperty()
```
  Логическое свойство, используемое для представления, находится ли таблица в режиме выбора строк или ячеек. По умолчанию таблица находится в режиме выбора строк, что означает, что отдельные ячейки не могут быть выбраны. Установка cellSelectionEnabled в true позволяет выбирать ячейки (но не строки).
  
  См. также:
  
  isCellSelectionEnabled(), setCellSelectionEnabled(boolean)
- setCellSelectionEnabled
```
public final void setCellSelectionEnabled(boolean value)
```
  Устанавливает значение свойства cellSelectionEnabled.
  
  Описание свойства:
  
  Логическое свойство, используемое для представления, находится ли таблица в режиме выбора строк или ячеек. По умолчанию таблица находится в режиме выбора строк, что означает, что отдельные ячейки не могут быть выбраны. Установка cellSelectionEnabled в true позволяет выбирать ячейки (но не строки).
- isCellSelectionEnabled
```
public final boolean isCellSelectionEnabled()
```
  Возвращает значение свойства cellSelectionEnabled.
  
  Описание свойства:
  
  Логическое свойство, используемое для представления, находится ли таблица в режиме выбора строк или ячеек. По умолчанию таблица находится в режиме выбора строк, что означает, что отдельные ячейки не могут быть выбраны. Установка cellSelectionEnabled в true позволяет выбирать ячейки (но не строки).
- 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 selection model, скорее всего, вернёт 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)
```
- 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. Функционально эквивалентно вызову getSelectedIndices().contains(index).
  
  Определено в:
  
  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.

Класс TableSelectionModel<T>

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

Свойства, унаследованные от класса javafx.scene.control.MultipleSelectionModel

Свойства, унаследованные от класса javafx.scene.control.SelectionModel

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

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

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

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

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

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

cellSelectionEnabled

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

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

isSelected

select

clearAndSelect

clearSelection

selectLeftCell

selectRightCell

selectAboveCell

selectBelowCell

selectRange

cellSelectionEnabledProperty

setCellSelectionEnabled

isCellSelectionEnabled

getSelectedIndices

getSelectedItems

getItemCount

getModelItem

focus

getFocusedIndex

clearAndSelect

select

select

selectIndices

selectAll

selectFirst

selectLast

clearSelection

clearSelection

isSelected

isEmpty

selectPrevious

selectNext