javafx.scene.control

Класс 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

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

Все методыМетоды экземпляровКонкретные методы
Тип	Свойство и описание
`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)
```
  Функция для проверки, выделена ли ячейка с заданными индексами строки и столбца в текущей таблице.
- select
```
public abstract void select(int row,
                            TableColumnBase<T,?> column)
```
  Выделяет ячейку по пересечению заданной строки и столбца.
- clearAndSelect
```
public abstract void clearAndSelect(int row,
                                    TableColumnBase<T,?> column)
```
  Очищает все выделения и затем выделяет ячейку по пересечению заданной строки и столбца.
- clearSelection
```
public abstract void clearSelection(int row,
                                    TableColumnBase<T,?> column)
```
  Удаляет выделение из указанной позиции строки/столбца (индексы представления). Если эта конкретная ячейка (или строка, если значение столбца равно -1) не выделена, ничего не происходит.
- 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), включительно.
- 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>
- 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

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

TableSelectionModel

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

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