Spec-Zone.ru › OpenJavaFX 24

Класс TableView.TableViewSelectionModel<S>

java.lang.Object
javafx.scene.control.SelectionModel<S>
javafx.scene.control.MultipleSelectionModel<S>
javafx.scene.control.TableSelectionModel<S>
javafx.scene.control.TableView.TableViewSelectionModel<S>
Параметры типа:
S - тип элемента, содержащегося в TableView
Вложенный класс:
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)
Этот метод проверяет, выбран ли данный индекс в данной модели выделения.
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 - минимальная строка
minColumn - минимальный столбец
maxRow - максимальная строка
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>
Возвращает:
список выбранных элементов

очиститьИВыбрать

public void clearAndSelect(int row)
Описание скопировано из класса: SelectionModel
Метод, очищающий предыдущий выбор перед установкой нового выбора по заданному индексу. Этот метод позволяет избежать необходимости вызова SelectionModel.clearSelection() в первую очередь, что означает, что наблюдатели, отслеживающие свойство selected index, не увидят временное изменение выбранного индекса на -1.
Указано в:
clearAndSelect в классе SelectionModel<T>
Параметры:
row - Индекс, который должен быть единственным выбранным индексом в этой модели выбора.

выбрать

public void select(int row)
Описание скопировано из класса: SelectionModel

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

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

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

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

выбрать

public void select(S obj)
Описание скопировано из класса: SelectionModel

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

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

выбратьИндексы

public void selectIndices(int row, int... rows)
Описание скопировано из класса: MultipleSelectionModel

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

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

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

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

выбратьВсе

public void selectAll()
Описание скопировано из класса: MultipleSelectionModel

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

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

выбратьПервый

public void selectFirst()
Описание скопировано из класса: MultipleSelectionModel

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

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

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

выбратьПоследний

public void selectLast()
Описание скопировано из класса: MultipleSelectionModel

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

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

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

очиститьВыбор

public void clearSelection(int index)
Описание скопировано из класса: SelectionModel

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

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

очиститьВыбор

public void clearSelection()
Описание скопировано из класса: SelectionModel

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

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

выбран

public boolean isSelected(int index)
Описание скопировано из класса: SelectionModel
Этот метод проверяет, выбран ли заданный индекс в данной SelectionModel.
Указано в:
isSelected в классе SelectionModel<T>
Параметры:
index - Индекс, который нужно проверить на предмет текущего выбора.
Возвращает:
true, если заданный индекс выбран, false в противном случае.

пустой

public boolean isEmpty()
Описание скопировано из класса: SelectionModel
Этот метод используется для проверки наличия выбранных индексов/элементов. Он вернёт true, если выбранных элементов нет, и false — если они есть.
Указано в:
isEmpty в классе SelectionModel<T>
Возвращает:
Возвращает true, если выбранных элементов нет, и false — если они есть.

выбратьПредыдущий

public void selectPrevious()
Описание скопировано из класса: SelectionModel

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

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

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

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

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

выбратьСледующий

public void selectNext()
Описание скопировано из класса: SelectionModel

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

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

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

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

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

Отправить отчет об ошибке или предложить улучшение
Авторские права © 2008, 2025, Oracle и/или его аффилированные лица. Все права защищены.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API