Spec-Zone.ru › OpenJavaFX 24

Класс TreeTableView.TreeTableViewSelectionModel<S>

java.lang.Object
javafx.scene.control.SelectionModel<TreeItem<S>>
javafx.scene.control.MultipleSelectionModel<TreeItem<S>>
javafx.scene.control.TableSelectionModel<TreeItem<S>>
javafx.scene.control.TreeTableView.TreeTableViewSelectionModel<S>
Type Parameters:
S - тип экземпляров TreeItem, используемых в этом TreeTableView
Enclosing class:
TreeTableView<S>
public abstract static class TreeTableView.TreeTableViewSelectionModel<S> extends TableSelectionModel<TreeItem<S>>
Простой расширение абстрактного класса SelectionModel для специальной поддержки элементов управления TreeTableView.
Since:
JavaFX 8.0

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

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

cellSelectionEnabled

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

selectionMode

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

selectedIndex, selectedItem

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

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

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

Модификатор и тип Метод Описание
void clearAndSelect(int row)
Метод, очищающий любой выбор перед установкой выбора на заданный индекс.
void clearSelection()
Очищает модель выбора всех выделенных индексов.
void clearSelection(int index)
Этот метод очистит выделение элемента в заданном индексе.
void focus(int row)
Фокусирует элемент в заданном индексе.
int getFocusedIndex()
Возвращает индекс фокусированного элемента.
protected int getItemCount()
Возвращает количество элементов в модели данных, лежащей в основе управления.
TreeItem<S> getModelItem(int index)
Возвращает элемент по заданному индексу.
abstract ObservableList<TreeTablePosition<S,?>> getSelectedCells()
Только для чтения ObservableList, представляющий текущие выделенные ячейки в этом TreeTableView.
ObservableList<Integer> getSelectedIndices()
Возвращает только для чтения ObservableList всех выделенных индексов.
ObservableList<TreeItem<S>> getSelectedItems()
Возвращает только для чтения ObservableList всех выделенных элементов.
TreeTableView<S> getTreeTableView()
Возвращает экземпляр TreeTableView, в котором установлена эта модель выбора.
boolean isEmpty()
Этот метод доступен для проверки наличия выделенных индексов/элементов.
boolean isSelected(int index)
Этот метод проверяет, выделен ли заданный индекс в этой SelectionModel.
void select(int row)
Этот метод выберет заданный индекс в модели выбора, предполагая, что индекс находится в допустимом диапазоне (т.е.
void select(TreeItem<S> obj)
Этот метод попытается выбрать индекс, содержащий данный объект.
void selectAll()
Удобный метод для выбора всех доступных индексов.
void selectFirst()
Этот метод попытается выбрать первый индекс в элементе управления.
void selectIndices(int row, int... rows)
Этот метод позволяет устанавливать один или несколько выборов одновременно.
void selectLast()
Этот метод попытается выбрать последний индекс в элементе управления.
void selectNext()
Этот метод попытается выбрать индекс, расположенный непосредственно после текущего фокусированного индекса.
void selectPrevious()
Этот метод попытается выбрать индекс, расположенный непосредственно перед текущим фокусированным индексом.
void selectRange(int minRow, TableColumnBase<TreeItem<S>,?> minColumn, int maxRow, TableColumnBase<TreeItem<S>,?> maxColumn)
Выбирает ячейки в диапазоне (minRow, minColumn) до (maxRow, maxColumn), включительно.

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

cellSelectionEnabledProperty, clearAndSelect, clearSelection, isCellSelectionEnabled, isSelected, select, 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

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

TreeTableViewSelectionModel

public TreeTableViewSelectionModel(TreeTableView<S> treeTableView)
Создаёт экземпляр TreeTableViewSelectionModel по умолчанию с предоставленным TreeTableView.
Параметры:
treeTableView - TreeTableView, на котором должен работать этот модель выбора.
Исключения:
NullPointerException - TreeTableView не может быть null.

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

getSelectedCells

public abstract ObservableList<TreeTablePosition<S,?>> getSelectedCells()
Только для чтения ObservableList, представляющий текущие выбранные ячейки в этом TreeTableView. Вместо непосредственного изменения этого списка, используйте другие методы, предоставленные в TreeTableViewSelectionModel.
Возвращает:
список выбранных ячеек

getTreeTableView

public TreeTableView<S> getTreeTableView()
Возвращает экземпляр TreeTableView, в котором установлена эта модель выбора.
Возвращает:
экземпляр TreeTableView, в котором установлена эта модель выбора

getModelItem

public TreeItem<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()
Получает индекс фокусированного элемента.
Возвращает:
индекс фокусированного элемента

selectRange

public void selectRange(int minRow, TableColumnBase<TreeItem<S>,?> minColumn, int maxRow, TableColumnBase<TreeItem<S>,?> maxColumn)
Выбирает ячейки в диапазоне (minRow, minColumn) до (maxRow, maxColumn), включительно.
Унаследованно от:
selectRange в классе TableSelectionModel<TreeItem<S>>
Параметры:
minRow - минимальная строка
minColumn - минимальный столбец
maxRow - максимальная строка
maxColumn - максимальный столбец

getSelectedIndices

public ObservableList<Integer> getSelectedIndices()
Описание скопировано из класса: MultipleSelectionModel

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

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

getSelectedItems

public ObservableList<TreeItem<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(TreeItem<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>
END_OF_DOCUMENT_MARKER

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
Этот метод проверяет, выбран ли заданный индекс в текущей модели выбора.
Указано в:
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 и/или его аффилированные лица. Все права защищены.

© 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