Класс TableColumn

java.lang.Object

javax.swing.table.TableColumn

Все реализованные интерфейсы:: Serializable

public class TableColumn extends Object implements Serializable

Объект

TableColumn

представляет все атрибуты столбца в таблице

JTable

, такие как ширина, возможность изменения размера, минимальная и максимальная ширина. Кроме того,

TableColumn

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

Также можно указать рендереры и редакторы на основе типа, а не на основе столбца — см. метод

setDefaultRenderer

в классе

JTable

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

TableColumn

является

null

TableColumn

хранит связь между столбцами в

JTable

и столбцами в

TableModel

modelIndex

— это столбец в

TableModel

, который будет запрошен для получения значений данных для ячеек в этом столбце. При перемещении столбца в представлении

modelIndex

не изменяется.

Примечание: Некоторые реализации могут предполагать, что все

TableColumnModel

уникальны, поэтому мы рекомендуем, чтобы один и тот же экземпляр

TableColumn

не добавлялся более одного раза в

TableColumnModel

. Чтобы отобразить

TableColumn

со столбцом данных из модели, создайте новый экземпляр с тем же

modelIndex

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с 1.4, поддержка долгосрочного хранения всех JavaBeans была добавлена в пакет

java.beans

. См. XMLEncoder.

См. также:

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

Модификатор и тип	Поле	Описание
`static final String`	`CELL_RENDERER_PROPERTY`	Устарело начиная с платформы Java 2 версии 1.3.
`protected TableCellEditor`	`cellEditor`	Редактор, используемый для редактирования ячеек данных столбца.
`protected TableCellRenderer`	`cellRenderer`	Компонент отрисовки, используемый для отображения ячеек данных столбца.
`static final String`	`COLUMN_WIDTH_PROPERTY`	Устарело начиная с платформы Java 2 версии 1.3.
`static final String`	`HEADER_RENDERER_PROPERTY`	Устарело начиная с платформы Java 2 версии 1.3.
`static final String`	`HEADER_VALUE_PROPERTY`	Устарело начиная с платформы Java 2 версии 1.3.
`protected TableCellRenderer`	`headerRenderer`	Компонент отрисовки, используемый для отображения заголовка столбца.
`protected Object`	`headerValue`	Значение заголовка столбца.
`protected Object`	`identifier`	Этот объект не используется внутренне механизмом отрисовки `JTable`; идентификаторы могут быть установлены в `TableColumn` как дополнительный способ маркировки и поиска столбцов таблицы.
`protected boolean`	`isResizable`	Если true, пользователю разрешено изменять размер столбца; по умолчанию true.
`protected int`	`maxWidth`	Максимальная ширина столбца.
`protected int`	`minWidth`	Минимальная ширина столбца.
`protected int`	`modelIndex`	Индекс столбца в модели, который должен отображаться этим `TableColumn`.
`protected int`	`resizedPostingDisableCount`	Deprecated. as of Java 2 platform v1.3
`protected int`	`width`	Ширина столбца.

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

Конструктор	Описание
`TableColumn()`	Общий метод, использующий индекс модели по умолчанию 0, ширину по умолчанию 75, компонент отрисовки `null` и редактор `null`.
`TableColumn(int modelIndex)`	Общий метод, использующий ширину по умолчанию 75, компонент отрисовки `null` и редактор `null`.
`TableColumn(int modelIndex, int width)`	Общий метод, использующий компонент отрисовки `null` и редактор `null`.
`TableColumn(int modelIndex, int width, TableCellRenderer cellRenderer, TableCellEditor cellEditor)`	Создает и инициализирует экземпляр `TableColumn` с указанным индексом модели, шириной, компонентом отрисовки ячеек и редактором ячеек; все конструкторы `TableColumn` делегируют вызов этому методу.

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

Модификатор и тип	Метод	Описание
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет `PropertyChangeListener` в список прослушивателей.
`protected TableCellRenderer`	`createDefaultHeaderRenderer()`	Начиная с платформы Java 2 версии 1.3, этот метод не вызывается конструктором `TableColumn`.
`void`	`disableResizedPosting()`	Deprecated. as of Java 2 platform v1.3
`void`	`enableResizedPosting()`	Deprecated. as of Java 2 platform v1.3
`TableCellEditor`	`getCellEditor()`	Возвращает `TableCellEditor`, используемый `JTable` для редактирования значений этого столбца.
`TableCellRenderer`	`getCellRenderer()`	Возвращает `TableCellRenderer`, используемый `JTable` для отрисовки значений этого столбца.
`TableCellRenderer`	`getHeaderRenderer()`	Возвращает `TableCellRenderer`, используемый для отрисовки заголовка `TableColumn`.
`Object`	`getHeaderValue()`	Возвращает `Object`, используемый в качестве значения для компонента отрисовки заголовка.
`Object`	`getIdentifier()`	Возвращает объект `identifier` для этого столбца.
`int`	`getMaxWidth()`	Возвращает максимальную ширину для `TableColumn`.
`int`	`getMinWidth()`	Возвращает минимальную ширину для `TableColumn`.
`int`	`getModelIndex()`	Возвращает индекс модели для этого столбца.
`int`	`getPreferredWidth()`	Возвращает предпочтительную ширину `TableColumn`.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Возвращает массив всех `PropertyChangeListener`, добавленных в этот TableColumn с помощью addPropertyChangeListener().
`boolean`	`getResizable()`	Возвращает true, если пользователю разрешено изменять ширину `TableColumn`, в противном случае false.
`int`	`getWidth()`	Возвращает ширину `TableColumn`.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет `PropertyChangeListener` из списка прослушивателей.
`void`	`setCellEditor(TableCellEditor cellEditor)`	Устанавливает редактор, используемый при редактировании ячейки в этом столбце.
`void`	`setCellRenderer(TableCellRenderer cellRenderer)`	Устанавливает `TableCellRenderer`, используемый `JTable` для отрисовки отдельных значений для этого столбца.
`void`	`setHeaderRenderer(TableCellRenderer headerRenderer)`	Устанавливает `TableCellRenderer`, используемый для отрисовки заголовка `TableColumn` в `headerRenderer`.
`void`	`setHeaderValue(Object headerValue)`	Устанавливает `Object`, строковое представление которого будет использоваться в качестве значения для `headerRenderer`.
`void`	`setIdentifier(Object identifier)`	Устанавливает идентификатор `TableColumn` в `anIdentifier`.
`void`	`setMaxWidth(int maxWidth)`	Устанавливает максимальную ширину `TableColumn` в `maxWidth` или, если `maxWidth` меньше минимальной ширины, в минимальную ширину.
`void`	`setMinWidth(int minWidth)`	Устанавливает минимальную ширину `TableColumn` в `minWidth`, при необходимости корректируя новую минимальную ширину, чтобы обеспечить 0 <= `minWidth` <= `maxWidth`.
`void`	`setModelIndex(int modelIndex)`	Устанавливает индекс модели для этого столбца.
`void`	`setPreferredWidth(int preferredWidth)`	Устанавливает предпочтительную ширину этого столбца в `preferredWidth`.
`void`	`setResizable(boolean isResizable)`	Устанавливает, можно ли изменять размер этого столбца.
`void`	`setWidth(int width)`	Этот метод не должен использоваться для установки ширины столбцов в `JTable`, используйте `setPreferredWidth` вместо этого.
`void`	`sizeWidthToFit()`	Изменяет размер `TableColumn`, чтобы он соответствовал ширине ячейки заголовка.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

COLUMN_WIDTH_PROPERTY

public static final String COLUMN_WIDTH_PROPERTY

Устарело начиная с Java 2 platform v1.3. Используйте строковые литералы для идентификации свойств.

См. также:

HEADER_VALUE_PROPERTY

public static final String HEADER_VALUE_PROPERTY

Устарело начиная с Java 2 platform v1.3. Используйте строковые литералы для идентификации свойств.

См. также:

HEADER_RENDERER_PROPERTY

public static final String HEADER_RENDERER_PROPERTY

Устарело начиная с Java 2 platform v1.3. Используйте строковые литералы для идентификации свойств.

См. также:

CELL_RENDERER_PROPERTY

public static final String CELL_RENDERER_PROPERTY

Устарело начиная с Java 2 platform v1.3. Используйте строковые литералы для идентификации свойств.

См. также:

modelIndex

protected int modelIndex

Индекс столбца в модели, который должен отображаться этим TableColumn. При перемещении столбцов в представлении modelIndex остается неизменным.

identifier

protected Object identifier

Этот объект не используется внутренними механизмами рисования JTable; идентификаторы могут быть заданы в TableColumn в качестве необязательного способа маркировки и поиска столбцов таблицы. Пакет таблицы не изменяет и не вызывает никаких методов в этих объектах-идентификаторах, кроме метода equals, который используется в методе getColumnIndex() в DefaultTableColumnModel.

width

protected int width

Ширина столбца.

minWidth

protected int minWidth

Минимальная ширина столбца.

maxWidth

protected int maxWidth

Максимальная ширина столбца.

headerRenderer

protected TableCellRenderer headerRenderer

Рисовальщик, используемый для отрисовки заголовка столбца.

headerValue

protected Object headerValue

Значение заголовка столбца.

cellRenderer

protected TableCellRenderer cellRenderer

Рисовальщик, используемый для отрисовки ячеек данных столбца.

cellEditor

protected TableCellEditor cellEditor

Редактор, используемый для редактирования ячеек данных столбца.

isResizable

protected boolean isResizable

Если true, пользователь может изменять размер столбца; по умолчанию — true.

resizedPostingDisableCount

@Deprecated protected transient int resizedPostingDisableCount

Устаревшее.

начиная с Java 2 platform v1.3

Это поле не использовалось в предыдущих версиях, и в настоящее время нет планов по его поддержке в будущем.

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

TableColumn

public TableColumn()

Метод-обёртка, использующий индекс модели по умолчанию 0, ширину по умолчанию 75, рисовалку по умолчанию и редактор по умолчанию. Этот метод предназначен для сериализации.

См. также:

TableColumn

public TableColumn(int modelIndex)

Метод-обёртка, использующий ширину по умолчанию 75, рисовалку по умолчанию и редактор по умолчанию.

Параметры:

modelIndex - индекс столбца в модели, предоставляющей данные для этого столбца в таблице; индекс модели остаётся неизменным даже при переупорядочении столбцов в представлении

См. также:

TableColumn

public TableColumn(int modelIndex, int width)

Метод-обёртка, использующий рисовалку по умолчанию и редактор по умолчанию.

Параметры:

width - предпочтительная ширина и начальная ширина этого столбца

См. также:

TableColumn

public TableColumn(int modelIndex, int width, TableCellRenderer cellRenderer, TableCellEditor cellEditor)

Создаёт и инициализирует экземпляр TableColumn со заданным индексом модели, шириной, рисовалкой ячейки и редактором ячейки; все TableColumn конструкторы делегируют этому. Значение width используется как для начальной, так и для предпочтительной ширины; если width отрицательное, они устанавливаются в 0. Минимальная ширина устанавливается в 15, если начальная ширина меньше, в противном случае минимальная ширина устанавливается равной начальной ширине.

Если параметр cellRenderer или cellEditor равен null, используется значение по умолчанию, предоставляемое методом JTable getDefaultRenderer или getDefaultEditor соответственно, для определения значений по умолчанию на основе типа данных в этом столбце. Эту стратегию рендеринга, ориентированную на столбцы, можно обойти, переопределив методы getCellRenderer в JTable.

Параметры:

width - предпочтительная ширина и начальная ширина этого столбца

cellRenderer - объект, используемый для рендеринга значений в этом столбце

cellEditor - объект, используемый для редактирования значений в этом столбце

См. также:

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

setModelIndex

@BeanProperty(description="The model index.") public void setModelIndex(int modelIndex)

Устанавливает индекс модели для этого столбца. Индекс модели — это индекс столбца в модели, который будет отображаться этим TableColumn. При перемещении TableColumn в представлении индекс модели остаётся неизменным.

Параметры:: modelIndex - новый индекс модели

getModelIndex

public int getModelIndex()

Возвращает индекс модели для этого столбца.

Возвращает:: свойство modelIndex

setIdentifier

@BeanProperty(description="A unique identifier for this column.") public void setIdentifier(Object identifier)

Устанавливает идентификатор столбца в anIdentifier.

Примечание: идентификаторы не используются JTable, они служат только для удобства внешней маркировки и определения местоположения столбцов.

Параметры:

identifier - идентификатор этого столбца

См. также:

getIdentifier

public Object getIdentifier()

Возвращает объект-идентификатор для этого столбца. Заметим, что идентификаторы не используются JTable, они служат только для удобства внешнего использования. Если identifier равен null, то getIdentifier() возвращает getHeaderValue в качестве значения по умолчанию.

Возвращает:

свойство identifier

См. также:

setHeaderValue

@BeanProperty(description="The text to be used by the header renderer.") public void setHeaderValue(Object headerValue)

Устанавливает Object, строковое представление которого будет использоваться как значение для headerRenderer. При создании TableColumn, значение по умолчанию для headerValue равно null.

Параметры:

headerValue - новое значение заголовка

См. также:

getHeaderValue

public Object getHeaderValue()

Возвращает Object, используемый в качестве значения для рендеринга заголовка.

Возвращает:

свойство headerValue

См. также:

setHeaderRenderer

@BeanProperty(description="The header renderer.") public void setHeaderRenderer(TableCellRenderer headerRenderer)

Устанавливает TableCellRenderer, используемый для отрисовки заголовка TableColumn в headerRenderer.

Ответственность за рендеринг индикатора сортировки лежит на рендерерах заголовка. Если вы используете сортировку и указываете рендерер, ваш рендерер должен отрисовывать индикатор сортировки.

Параметры:

headerRenderer - новый headerRenderer

См. также:

getHeaderRenderer

public TableCellRenderer getHeaderRenderer()

Возвращает TableCellRenderer, используемый для отрисовки заголовка TableColumn. Когда headerRenderer равен null, JTableHeader использует свой defaultRenderer. Значение по умолчанию для headerRenderer равно null.

Возвращает:

свойство headerRenderer

См. также:

setCellRenderer

@BeanProperty(description="The renderer to use for cell values.") public void setCellRenderer(TableCellRenderer cellRenderer)

Устанавливает TableCellRenderer, используемый JTable для отрисовки отдельных значений для этого столбца.

Параметры:

cellRenderer - новый cellRenderer

См. также:

getCellRenderer

public TableCellRenderer getCellRenderer()

Возвращает TableCellRenderer, используемый JTable для отрисовки значений для этого столбца. cellRenderer столбца не только управляет визуальным видом столбца, но также используется для интерпретации объекта значения, предоставляемого TableModel. Когда cellRenderer равен null, JTable использует рендерер по умолчанию, основанный на классе ячеек в этом столбце. Значение по умолчанию для cellRenderer равно null.

Возвращает:

свойство cellRenderer

См. также:

setCellEditor

@BeanProperty(description="The editor to use for cell values.") public void setCellEditor(TableCellEditor cellEditor)

Устанавливает редактор, используемый при редактировании ячейки в этом столбце.

Параметры:

cellEditor - новый cellEditor

См. также:

getCellEditor

public TableCellEditor getCellEditor()

Возвращает TableCellEditor, используемый JTable для редактирования значений для этого столбца. Когда cellEditor равен null, JTable использует редактор по умолчанию, основанный на классе ячеек в этом столбце. Значение по умолчанию для cellEditor равно null.

Возвращает:

свойство cellEditor

См. также:

setWidth

@BeanProperty(description="The width of the column.") public void setWidth(int width)

Этот метод не следует использовать для установки ширины столбцов в JTable, используйте setPreferredWidth вместо этого. Как и менеджер компоновки в AWT, JTable автоматически корректирует ширину столбца всякий раз, когда таблица сама изменяет размер или изменяется предпочтительная ширина столбца. Поэтому программирование ширины не оказывает долгосрочного влияния.

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

Параметры:

width - новая ширина

См. также:

getWidth

public int getWidth()

Возвращает ширину TableColumn. Значение по умолчанию равно 75.

Возвращает:

свойство width

См. также:

setPreferredWidth

@BeanProperty(description="The preferred width of the column.") public void setPreferredWidth(int preferredWidth)

Устанавливает предпочтительную ширину этого столбца в preferredWidth. Если preferredWidth превышает минимальную или максимальную ширину, она корректируется до соответствующего предельного значения.

Для получения подробной информации о том, как вычисляются ширины столбцов в JTable (и JTableHeader) из preferredWidth, см. метод doLayout в JTable.

Параметры:

preferredWidth - новая предпочтительная ширина

См. также:

getPreferredWidth

public int getPreferredWidth()

Возвращает предпочтительную ширину TableColumn. Значение по умолчанию равно 75.

Возвращает:

свойство preferredWidth

См. также:

setMinWidth

@BeanProperty(description="The minimum width of the column.") public void setMinWidth(int minWidth)

Устанавливает минимальную ширину TableColumn в minWidth, корректируя новую минимальную ширину при необходимости, чтобы гарантировать, что 0 <= minWidth <= maxWidth. Например, если аргумент minWidth отрицательный, этот метод устанавливает свойство minWidth в 0.

Если значение свойства width или preferredWidth меньше новой минимальной ширины, этот метод устанавливает это свойство в новую минимальную ширину.

Параметры:

minWidth - новая минимальная ширина

См. также:

getMinWidth

public int getMinWidth()

Возвращает минимальную ширину для TableColumn. Ширина TableColumn не может быть меньше этого значения ни пользователем, ни программно.

Возвращает:

свойство minWidth

См. также:

setMaxWidth

@BeanProperty(description="The maximum width of the column.") public void setMaxWidth(int maxWidth)

Устанавливает максимальную ширину TableColumn в maxWidth или, если maxWidth меньше минимальной ширины, в минимальную ширину.

Если значение свойства width или preferredWidth больше новой максимальной ширины, этот метод устанавливает это свойство в новую максимальную ширину.

Параметры:

maxWidth - новая максимальная ширина

См. также:

getMaxWidth

public int getMaxWidth()

Возвращает максимальную ширину для TableColumn. Ширина TableColumn не может быть больше этого значения ни пользователем, ни программно. Значение по умолчанию для maxWidth равно Integer.MAX_VALUE.

Возвращает:

свойство maxWidth

См. также:

setResizable

@BeanProperty(description="Whether or not this column can be resized.") public void setResizable(boolean isResizable)

Устанавливает, можно ли изменять размер этого столбца.

Параметры:

isResizable - если true, изменение размера разрешено; иначе false

См. также:

getResizable

public boolean getResizable()

Возвращает true, если пользователь может изменять ширину TableColumn, в противном случае false. Вы можете программно изменить ширину независимо от этого параметра. По умолчанию значение равно true.

Returns:

свойство isResizable

См. также:

sizeWidthToFit

public void sizeWidthToFit()

Изменяет размер TableColumn для соответствия ширине ячейки заголовка. Этот метод ничего не делает, если рендерер заголовка null (случай по умолчанию). В противном случае он устанавливает минимальную, максимальную и предпочтительную ширину этого столбца на ширину минимального, максимального и предпочтительного размеров компонента, предоставленного рендерером заголовка. Переменная «ширина» этого объекта TableColumn также устанавливается на предпочтительную ширину. Обратите внимание, что этот метод не используется внутри пакета таблицы.

См. также:

disableResizedPosting

@Deprecated public void disableResizedPosting()

Устарело.

с версии Java 2 платформы v1.3

Это поле не использовалось в предыдущих выпусках, и в настоящее время нет планов по его поддержке в будущем.

enableResizedPosting

@Deprecated public void enableResizedPosting()

Устарело.

с версии Java 2 платформы v1.3

Это поле не использовалось в предыдущих выпусках, и в настоящее время нет планов по его поддержке в будущем.

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

Добавляет PropertyChangeListener в список слушателей. Слушатель регистрируется для всех связанных свойств этого класса, включая следующие:

modelIndex столбца TableColumn ("modelIndex")
идентификатор столбца TableColumn ("identifier")
значение заголовка столбца TableColumn ("headerValue")
рендерер заголовка столбца TableColumn ("headerRenderer")
рендерер ячейки столбца TableColumn ("cellRenderer")
редактор ячейки столбца TableColumn ("cellEditor")
ширина столбца TableColumn ("width")
предпочтительная ширина столбца TableColumn ("preferredWidth")
минимальная ширина столбца TableColumn ("minWidth")
максимальная ширина столбца TableColumn ("maxWidth")
состояние масштабируемости столбца TableColumn ("isResizable")

Parameters:

listener - добавляемый слушатель

См. также:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

Удаляет PropertyChangeListener из списка слушателей. PropertyChangeListener, который нужно удалить, был зарегистрирован для всех свойств.

Parameters:: listener - слушатель, который нужно удалить

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

Возвращает массив всех PropertyChangeListener, добавленных в этот объект TableColumn с помощью addPropertyChangeListener().

Returns:: все добавленные PropertyChangeListener или пустой массив, если слушатели не добавлены
Since:: 1.4

createDefaultHeaderRenderer

protected TableCellRenderer createDefaultHeaderRenderer()

С версии Java 2 платформы v1.3 этот метод не вызывается конструктором TableColumn. Ранее этот метод использовался TableColumn для создания рендерера заголовка по умолчанию. С версии Java 2 платформы v1.3 рендерер заголовка по умолчанию null. JTableHeader теперь предоставляет собственный общий рендерер по умолчанию, точно так же, как JTable для своих рендереров ячеек.

Returns:

рендерер заголовка по умолчанию

См. также:

© 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/TableColumn.html