Класс 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`	`clearAndSelect(int row, TableColumnBase<S,?> column)`	Очищает весь выбор и затем выбирает ячейку в заданном пересечении строки/столбца.
`void`	`clearSelection()`	Очищает модель выбора всех выбранных индексов.
`void`	`clearSelection(int index)`	Этот метод очистит выбор элемента в заданном индексе.
`abstract void`	`clearSelection(int row, TableColumn<S,?> column)`	Удаляет выбор из указанной позиции строки/столбца (в индексах представления).
`void`	`clearSelection(int row, TableColumnBase<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)`	Удобная функция, проверяющая, выбрана ли указанная строка и столбец в данном экземпляре таблицы.
`boolean`	`isSelected(int row, TableColumnBase<S,?> column)`	Удобная функция, проверяющая, выбрана ли указанная строка и столбец в данном экземпляре таблицы.
`void`	`select(int row)`	Это выберет данный индекс в модели выбора, предполагая, что индекс находится в допустимом диапазоне (т.е.
`abstract void`	`select(int row, TableColumn<S,?> column)`	Выбирает ячейку в заданном пересечении строки/столбца.
`void`	`select(int row, TableColumnBase<S,?> column)`	Выбирает ячейку в заданном пересечении строки/столбца.
`void`	`select(S obj)`	Этот метод попытается выбрать индекс, содержащий данный объект.
`void`	`selectAll()`	Удобный метод для выбора всех доступных индексов.
`void`	`selectFirst()`	Этот метод попытается выбрать первый индекс в элементе управления.
`void`	`selectIndices(int row, int... rows)`	Этот метод позволяет установить один или несколько выборов одновременно.
`void`	`selectLast()`	Этот метод попытается выбрать последний индекс в элементе управления.
`void`	`selectNext()`	Этот метод попытается выбрать индекс, непосредственно следующий за текущим фокусированным индексом.
`void`	`selectPrevious()`	Этот метод попытается выбрать индекс, непосредственно предшествующий текущему фокусированному индексу.
`void`	`selectRange(int minRow, TableColumnBase<S,?> minColumn, int maxRow, TableColumnBase<S,?> maxColumn)`	Выбирает ячейки в диапазоне (minRow, minColumn) до (maxRow, maxColumn), включительно.

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

cellSelectionEnabledProperty, isCellSelectionEnabled, selectAboveCell, selectBelowCell, selectLeftCell, 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 boolean isSelected(int row, TableColumnBase<S,?> column)

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

Определено в:: isSelected в классе TableSelectionModel<S>
Параметры:: row - строка; column - столбец
Возвращает:: true, если данная строка и столбец выбраны в текущей таблице

isSelected

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

Вспомогательная функция, которая проверяет, выбрана ли данная строка и столбец в текущей таблице.

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

select

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

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

Определено в:: select в классе TableSelectionModel<S>
Параметры:: row - строка; column - столбец

select

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

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

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

clearAndSelect

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

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

Определено в:: clearAndSelect в классе TableSelectionModel<S>
Параметры:: row - строка; column - столбец

clearAndSelect

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

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

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

clearSelection

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

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

Определено в:: clearSelection в классе TableSelectionModel<S>
Параметры:: row - строка; column - столбец

clearSelection

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

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

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

selectRange

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

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

Определено в:: selectRange в классе TableSelectionModel<S>
Параметры:: minRow - minRow; minColumn - minColumn; maxRow - maxRow; maxColumn - maxColumn

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)

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

Параметры:: 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

Этот метод проверяет, выбран ли данный индекс в данной 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.