Класс TableView.TableViewSelectionModel<S>

java.lang.Object

javafx.scene.control.SelectionModel<T>

javafx.scene.control.MultipleSelectionModel<T>

javafx.scene.control.TableSelectionModel<S>

javafx.scene.control.TableView.TableViewSelectionModel<S>

Вложенный класс:: TableView<S>

public abstract static class TableView.TableViewSelectionModel<S>
extends TableSelectionModel<S>

Простой расширение абстрактного класса SelectionModel, позволяющее реализовать специальную поддержку для элементов управления TableView.

С:: JavaFX 2.0

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

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

cellSelectionEnabled

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

selectionMode

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

selectedIndex, selectedItem

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

Конструкторы
Конструктор	Описание
`TableViewSelectionModel(TableView<S> tableView)`	Создает экземпляр TableViewSelectionModel по умолчанию с предоставленным TableView.

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

Модификатор и тип	Метод	Описание
`void`	`clearAndSelect(int row)`	Метод, очищающий любой выбор перед установкой выбора на заданный индекс.
`abstract void`	`clearAndSelect(int row, TableColumn<S,?> column)`	Очищает весь выбор и затем выбирает ячейку в заданной строке/столбце.
`void`	`clearSelection()`	Очищает модель выбора всех выбранных индексов.
`void`	`clearSelection(int index)`	Метод, очищающий выбор элемента в заданном индексе.
`abstract void`	`clearSelection(int row, TableColumn<S,?> column)`	Удаляет выбор из указанной позиции строки/столбца (в индексах представления).
`void`	`focus(int row)`
`int`	`getFocusedIndex()`
`protected int`	`getItemCount()`	Возвращает количество элементов в модели данных, лежащей в основе элемента управления.
`protected S`	`getModelItem(int index)`	Возвращает элемент по заданному индексу.
`abstract ObservableList<TablePosition>`	`getSelectedCells()`	Только для чтения ObservableList, представляющий текущие выбранные ячейки в этом TableView.
`ObservableList<Integer>`	`getSelectedIndices()`	Возвращает только для чтения ObservableList всех выбранных индексов.
`ObservableList<S>`	`getSelectedItems()`	Возвращает только для чтения ObservableList всех выбранных элементов.
`protected List<S>`	`getTableModel()`	Удобный метод, возвращающий getTableView().getItems().
`TableView<S>`	`getTableView()`	Возвращает экземпляр TableView, в котором установлена эта модель выбора.
`boolean`	`isEmpty()`	Этот метод доступен для проверки наличия выбранных индексов/элементов.
`boolean`	`isSelected(int index)`	Удобный метод для проверки, является ли данный индекс выбранным в данном SelectionModel.
`abstract boolean`	`isSelected(int row, TableColumn<S,?> column)`	Удобная функция, проверяющая, выбрана ли данная строка и столбец в этом экземпляре таблицы.
`void`	`select(int row)`	Это выберет указанный индекс в модели выбора, предполагая, что индекс находится в допустимом диапазоне (т.е.
`abstract void`	`select(int row, TableColumn<S,?> column)`	Выбирает ячейку в заданной строке/столбце.
`void`	`select(S obj)`	Этот метод попытается выбрать индекс, содержащий данный объект.
`void`	`selectAll()`	Удобный метод для выбора всех доступных индексов.
`void`	`selectFirst()`	Этот метод попытается выбрать первый индекс в элементе управления.
`void`	`selectIndices(int row, int... rows)`	Этот метод позволяет одновременно устанавливать один или несколько выборов.
`void`	`selectLast()`	Этот метод попытается выбрать последний индекс в элементе управления.
`void`	`selectNext()`	Этот метод попытается выбрать индекс, непосредственно следующий за текущим фокусированным индексом.
`void`	`selectPrevious()`	Этот метод попытается выбрать индекс, непосредственно предшествующий текущему фокусированному индексу.

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

cellSelectionEnabledProperty, clearAndSelect, clearSelection, isCellSelectionEnabled, isSelected, select, selectAboveCell, selectBelowCell, selectLeftCell, selectRange, selectRightCell, setCellSelectionEnabled

Методы, объявленные в классе 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

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

TableViewSelectionModel

public TableViewSelectionModel(TableView<S> tableView)

Создаёт экземпляр TableViewSelectionModel по умолчанию с предоставленной TableView.

Параметры:: tableView - TableView, для которого должен работать этот модель выбора.
Исключения:: NullPointerException - TableView не может быть null.

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

getSelectedCells

public abstract ObservableList<TablePosition> getSelectedCells()

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

Возвращает:: только для чтения ObservableList, представляющий текущие выбранные ячейки в этой TableView

isSelected

public abstract boolean isSelected(int row, TableColumn<S,?> column)

Функция для удобства проверки, выбрана ли ячейка с заданными индексом строки и столбца в данном экземпляре таблицы.

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

select

public abstract void select(int row, TableColumn<S,?> column)

Выбирает ячейку на пересечении заданной строки и столбца.

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

clearAndSelect

public abstract void clearAndSelect(int row, TableColumn<S,?> column)

Очищает все выделения и затем выбирает ячейку на пересечении заданной строки и столбца.

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

clearSelection

public abstract void clearSelection(int row, TableColumn<S,?> column)

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

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

getTableView

public TableView<S> getTableView()

Возвращает экземпляр TableView, в котором установлена эта модель выбора.

Возвращает:: экземпляр TableView

getTableModel

protected List<S> getTableModel()

Удобный метод, который возвращает getTableView().getItems().

Возвращает:: список элементов текущей TableView.

getModelItem

protected S getModelItem(int index)

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

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

getItemCount

protected int getItemCount()

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

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

focus

public void focus(int row)

getFocusedIndex

public int getFocusedIndex()

getSelectedIndices

public ObservableList<Integer> getSelectedIndices()

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

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

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

getSelectedItems

public ObservableList<S> getSelectedItems()

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

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

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

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(S 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

Удобный метод для проверки, выбран ли заданный индекс в текущей модели выбора. Функционально эквивалентен вызову 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.