Класс TableView.TableViewSelectionModel
- javafx.scene.control.SelectionModel<T>
-
- javafx.scene.control.MultipleSelectionModel<T>
-
- javafx.scene.control.TableSelectionModel<S>
-
- javafx.scene.control.TableView.TableViewSelectionModel<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.
-
Краткое описание методов
Все методыМетоды экземпляровАбстрактные методыКонкретные методы Модификатор и тип Метод и описание voidclearAndSelect(int row)Метод, очищающий предыдущий выбор перед установкой выбора в заданный индекс.abstract voidclearAndSelect(int row, TableColumn<S,?> column)Очищает весь выбор и затем выбирает ячейку по заданной строке/столбцу.voidclearAndSelect(int row, TableColumnBase<S,?> column)Очищает весь выбор и затем выбирает ячейку по заданной строке/столбцу.voidclearSelection()Очищает модель выбора всех выбранных индексов.voidclearSelection(int index)Этот метод очистит выбор элемента в заданном индексе.abstract voidclearSelection(int row, TableColumn<S,?> column)Удаляет выбор из указанной строки/столбца (индексы в представлении).voidclearSelection(int row, TableColumnBase<S,?> column)Удаляет выбор из указанной строки/столбца (индексы в представлении).voidfocus(int row)intgetFocusedIndex()protected intgetItemCount()Возвращает количество элементов в модели данных, которая лежит в основе управления.protected SgetModelItem(int index)Возвращает элемент в заданном индексе.abstract ObservableList<TablePosition>getSelectedCells()Только для чтения ObservableList, представляющий текущие выбранные ячейки в этом TableView.ObservableList<Integer>getSelectedIndices()Возвращает только для чтения ObservableList всех выбранных индексов.ObservableList<T>getSelectedItems()Возвращает только для чтения ObservableList всех выбранных элементов.protected List<S>getTableModel()Удобный метод, возвращающий getTableView().getItems().TableView<S>getTableView()Возвращает экземпляр TableView, в котором установлена эта модель выбора.booleanisEmpty()Этот метод доступен для проверки наличия выбранных индексов/элементов.booleanisSelected(int index)Удобный метод для проверки, является ли заданный индекс текущим выбранным в этой SelectionModel.abstract booleanisSelected(int row, TableColumn<S,?> column)Удобная функция, проверяющая, является ли заданный индекс строки и столбца текущим выбранным в этом экземпляре таблицы.booleanisSelected(int row, TableColumnBase<S,?> column)Удобная функция, проверяющая, является ли заданный индекс строки и столбца текущим выбранным в этом экземпляре таблицы.voidselect(int row)Это выберет указанный индекс в модели выбора, предполагая, что индекс находится в допустимом диапазоне (т.е.abstract voidselect(int row, TableColumn<S,?> column)Выбирает ячейку по заданной строке/столбцу.voidselect(int row, TableColumnBase<S,?> column)Выбирает ячейку по заданной строке/столбцу.voidselect(T obj)Этот метод попытается выбрать индекс, содержащий данный объект.voidselectAll()Удобный метод для выбора всех доступных индексов.voidselectFirst()Этот метод попытается выбрать первый индекс в элементе управления.voidselectIndices(int row, int... rows)Этот метод позволяет устанавливать один или несколько выборов одновременно.voidselectLast()Этот метод попытается выбрать последний индекс в элементе управления.voidselectNext()Этот метод попытается выбрать индекс непосредственно после текущего фокусированного индекса.voidselectPrevious()Этот метод попытается выбрать индекс непосредственно перед текущим фокусированным индексом.voidselectRange(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
-
-
Подробное описание конструкторов
-
TableViewSelectionModel
public TableViewSelectionModel(TableView<S> tableView)
Создаёт экземпляр TableViewSelectionModel по умолчанию с предоставленным TableView.Параметры:
tableView- TableView, на котором должна работать эта модель выбора.Исключения:
NullPointerException- TableView не может быть null.
-
-
Подробное описание методов
-
getSelectedCells
public abstract ObservableList<TablePosition> getSelectedCells()
Только для чтения ObservableList, представляющий текущие выбранные ячейки в этой TableView. Вместо непосредственного изменения этого списка, используйте другие методы, предоставленные в TableViewSelectionModel.
-
isSelected
public boolean isSelected(int row, TableColumnBase<S,?> column)Удобная функция, проверяющая, выбрана ли данная строка и столбец в текущем экземпляре таблицы.Определено:
isSelectedв классеTableSelectionModel<S>
-
isSelected
public abstract boolean isSelected(int row, TableColumn<S,?> column)Удобная функция, проверяющая, выбрана ли данная строка и столбец в текущем экземпляре таблицы.
-
select
public void select(int row, TableColumnBase<S,?> column)Выбирает ячейку на пересечении заданной строки и столбца.Определено:
selectв классеTableSelectionModel<S>
-
select
public abstract void select(int row, TableColumn<S,?> column)Выбирает ячейку на пересечении заданной строки и столбца.
-
clearAndSelect
public void clearAndSelect(int row, TableColumnBase<S,?> column)Очищает все выделения и затем выбирает ячейку на пересечении заданной строки и столбца.Определено:
clearAndSelectв классеTableSelectionModel<S>
-
clearAndSelect
public abstract void clearAndSelect(int row, TableColumn<S,?> column)Очищает все выделения и затем выбирает ячейку на пересечении заданной строки и столбца.
-
clearSelection
public void clearSelection(int row, TableColumnBase<S,?> column)Удаляет выделение из указанной строки/столбца (в индексах представления). Если эта конкретная ячейка (или строка, если значение столбца равно -1) не выбрана, ничего не происходит.Определено:
clearSelectionв классеTableSelectionModel<S>
-
clearSelection
public abstract void clearSelection(int row, TableColumn<S,?> column)Удаляет выделение из указанной строки/столбца (в индексах представления). Если эта конкретная ячейка (или строка, если значение столбца равно -1) не выбрана, ничего не происходит.
-
selectRange
public void selectRange(int minRow, TableColumnBase<S,?> minColumn, int maxRow, TableColumnBase<S,?> maxColumn)Выбирает ячейки в диапазоне (minRow, minColumn) до (maxRow, maxColumn), включительно.Определено:
selectRangeв классеTableSelectionModel<S>
-
getTableView
public TableView<S> getTableView()
Возвращает экземпляр 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<T> 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(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.