Интерфейс TableColumnModel
- Все известные реализующие классы:
DefaultTableColumnModel
public interface TableColumnModel
Определяет требования к объекту модели столбцов таблицы, подходящему для использования с
JTable.- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addColumn |
Добавляет aColumn в конец массива tableColumns. |
void |
addColumnModelListener |
Добавляет слушателя событий модели столбцов таблицы. |
TableColumn |
getColumn |
Возвращает объект TableColumn для столбца по индексу columnIndex. |
int |
getColumnCount() |
Возвращает количество столбцов в модели. |
int |
getColumnIndex |
Возвращает индекс первого столбца в таблице, идентификатор которого равен identifier, при сравнении с использованием equals. |
int |
getColumnIndexAtX |
Возвращает индекс столбца, соответствующего горизонтальной координате xPosition; или -1, если координата находится вне границ столбцов. |
int |
getColumnMargin() |
Возвращает ширину между ячейками в каждом столбце. |
Enumeration |
getColumns() |
Возвращает Enumeration всех столбцов в модели. |
boolean |
getColumnSelectionAllowed() |
Возвращает true, если столбцы могут быть выбраны. |
int |
getSelectedColumnCount() |
Возвращает количество выбранных столбцов. |
int[] |
getSelectedColumns() |
Возвращает массив индексов всех выбранных столбцов. |
ListSelectionModel |
getSelectionModel() |
Возвращает текущую модель выбора. |
int |
getTotalColumnWidth() |
Возвращает общую ширину всех столбцов. |
void |
moveColumn |
Перемещает столбец и его заголовок с индексом columnIndex на позицию newIndex. |
void |
removeColumn |
Удаляет TableColumn column из массива tableColumns. |
void |
removeColumnModelListener |
Удаляет слушателя событий модели столбцов таблицы. |
void |
setColumnMargin |
Устанавливает отступ столбцов модели на TableColumn в newMargin. |
void |
setColumnSelectionAllowed |
Устанавливает возможность выбора столбцов в этой модели. |
void |
setSelectionModel |
Устанавливает модель выбора. |
Методы
addColumn
void addColumn(TableColumn aColumn)
Добавляет
aColumn в конец массива tableColumns. Этот метод публикует событие columnAdded своим слушателям.- Параметры:
-
aColumn- добавляемаяTableColumn - См. также:
removeColumn
void removeColumn(TableColumn column)
Удаляет
TableColumn column из массива tableColumns. Этот метод ничего не сделает, если column не находится в списке столбцов таблицы. Этот метод публикует событие columnRemoved своим слушателям.- Параметры:
-
column- удаляемыйTableColumn - См. также:
moveColumn
void moveColumn(int columnIndex, int newIndex)
Перемещает столбец и его заголовок из
columnIndex в newIndex. Прежний столбец в columnIndex теперь будет находиться в newIndex. Столбец, который раньше находился в newIndex, смещается влево или вправо, чтобы освободить место. Этот метод ничего не сделает, если columnIndex равно newIndex. Этот метод публикует событие columnMoved своим слушателям.- Параметры:
-
columnIndex- индекс перемещаемого столбца -
newIndex- индекс нового местоположения столбца - Исключения:
-
IllegalArgumentException- еслиcolumnIndexилиnewIndexнаходятся вне допустимого диапазона
setColumnMargin
void setColumnMargin(int newMargin)
Устанавливает отступ столбца
TableColumn в newMargin. Этот метод публикует событие columnMarginChanged своим слушателям.- Параметры:
-
newMargin- ширина нового отступа столбца в пикселях - См. также:
getColumnCount
int getColumnCount()
Возвращает количество столбцов в модели.
- Возвращает:
- количество столбцов в модели
getColumns
Enumeration<TableColumn> getColumns()
Возвращает
Enumeration всех столбцов в модели.- Возвращает:
Enumerationвсех столбцов в модели
getColumnIndex
int getColumnIndex(Object columnIdentifier)
Возвращает индекс первого столбца в таблице, идентификатор которого равен
identifier, при сравнении с использованием equals. - Параметры:
-
columnIdentifier- объект идентификатора - Возвращает:
- индекс первого столбца таблицы, идентификатор которого равен
identifier - Исключения:
-
IllegalArgumentException- еслиidentifierявляетсяnull, или ни одинTableColumnне имеет этогоidentifier - См. также:
getColumn
TableColumn getColumn(int columnIndex)
Возвращает объект
TableColumn для столбца с индексом columnIndex.- Параметры:
-
columnIndex- индекс нужного столбца - Возвращает:
- объект
TableColumnдля столбца с индексомcolumnIndex
getColumnMargin
int getColumnMargin()
Возвращает ширину между ячейками в каждом столбце.
- Возвращает:
- отступ в пикселях между ячейками
getColumnIndexAtX
int getColumnIndexAtX(int xPosition)
Возвращает индекс столбца, находящегося в горизонтальной точке,
xPosition; или -1, если он находится вне границ любого из столбцов. В соответствии с архитектурой разделяемой модели Swing, TableColumnModel не знает, как фактически отображаются столбцы таблицы на экране. Визуальное представление столбцов является обязанностью объекта представления/контроллера, использующего эту модель (как правило, JTable). Представление/контроллер не обязательно должен отображать столбцы последовательно слева направо. Например, столбцы могут отображаться справа налево для соответствия настройкам региональных параметров или некоторые столбцы могут быть скрыты по запросу пользователя. Так как модель не знает, как столбцы расположены на экране, заданный xPosition не следует рассматривать как координату в 2D графическом пространстве. Вместо этого его следует рассматривать как ширину от начала первого столбца в модели. Если требуется индекс столбца для заданной координаты X в 2D пространстве, можно использовать JTable.columnAtPoint вместо этого.- Параметры:
-
xPosition- ширина от начала первого столбца в модели. - Возвращает:
- индекс столбца; или -1, если столбец не найден
- См. также:
getTotalColumnWidth
int getTotalColumnWidth()
Возвращает общую ширину всех столбцов.
- Возвращает:
- общую вычисленную ширину всех столбцов
setColumnSelectionAllowed
void setColumnSelectionAllowed(boolean flag)
Устанавливает, разрешена ли возможность выбора столбцов в этой модели.
- Параметры:
-
flag- true, если выбор столбцов разрешен; в противном случае false - См. также:
getColumnSelectionAllowed
boolean getColumnSelectionAllowed()
Возвращает true, если выбор столбцов разрешен.
- Возвращает:
- true, если выбор столбцов разрешен
- См. также:
getSelectedColumns
int[] getSelectedColumns()
Возвращает массив индексов всех выбранных столбцов.
- Возвращает:
- массив целых чисел, содержащих индексы всех выбранных столбцов; или пустой массив, если ничего не выбрано
getSelectedColumnCount
int getSelectedColumnCount()
Возвращает количество выбранных столбцов.
- Возвращает:
- количество выбранных столбцов; или 0, если столбцы не выбраны
setSelectionModel
void setSelectionModel(ListSelectionModel newModel)
Устанавливает модель выбора.
- Параметры:
-
newModel- объектListSelectionModel - См. также:
getSelectionModel
ListSelectionModel getSelectionModel()
Возвращает текущую модель выбора.
- Возвращает:
- объект
ListSelectionModel - См. также:
addColumnModelListener
void addColumnModelListener(TableColumnModelListener x)
Добавляет слушателя событий модели столбцов таблицы.
- Параметры:
-
x- объектTableColumnModelListener
removeColumnModelListener
void removeColumnModelListener(TableColumnModelListener x)
Удаляет слушателя событий модели столбцов таблицы.
- Параметры:
-
x- объектTableColumnModelListener
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/table/TableColumnModel.html