Интерфейс 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<TableColumn> |
getColumns() |
Возвращает массив всех столбцов в модели. |
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, 2021, 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/17/docs/api/java.desktop/javax/swing/table/TableColumnModel.html