Класс 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`	Устарело. начиная с платформы Java 2 версии 1.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()`	Устарело. начиная с платформы Java 2 версии 1.3
`void`	`enableResizedPosting()`	Устарело. начиная с платформы Java 2 версии 1.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` так, чтобы он соответствовал ширине ячейки заголовка.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или прерывания, либо до истечения заданного промежутка времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или прерывания, либо до истечения заданного промежутка времени.

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

COLUMN_WIDTH_PROPERTY

public static final String COLUMN_WIDTH_PROPERTY

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

См. также:

HEADER_VALUE_PROPERTY

public static final String HEADER_VALUE_PROPERTY

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

См. также:

HEADER_RENDERER_PROPERTY

public static final String HEADER_RENDERER_PROPERTY

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

См. также:

CELL_RENDERER_PROPERTY

public static final String CELL_RENDERER_PROPERTY

Устарело начиная с платформы Java 2 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 v1.3

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

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

TableColumn

public TableColumn()

Вспомогательный метод, использующий индекс модели по умолчанию 0, ширину по умолчанию 75, средство визуализации null и редактор null. Этот метод предназначен для сериализации.

См. также:

TableColumn

public TableColumn(int modelIndex)

Вспомогательный метод, использующий ширину по умолчанию 75, средство визуализации null и редактор null.

Параметры:

modelIndex — индекс столбца в модели, которая предоставляет данные для этого столбца таблицы; индекс модели остается неизменным, даже если столбцы меняются местами в представлении

См. также:

TableColumn

public TableColumn(int modelIndex, int width)

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

Параметры:

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 — новый modelIndex

getModelIndex

public int getModelIndex()

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

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

setIdentifier

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

Задает идентификатор TableColumn как anIdentifier.

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

Параметры:

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

См. также:

getIdentifier

public Object getIdentifier()

Возвращает объект identifier для этого столбца. Обратите внимание, что идентификаторы не используются в 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 — новое значение 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.

Возвращает:

свойство isResizable

См. также:

sizeWidthToFit

public void sizeWidthToFit()

Изменяет размер TableColumn так, чтобы он соответствовал ширине ячейки заголовка. Если средство визуализации заголовка равно null (значение по умолчанию), этот метод ничего не делает. В противном случае он задает минимальную, максимальную и предпочтительную ширину этого столбца, равные соответствующим размерам компонента, предоставленного средством визуализации заголовка. Временное свойство "width" этого 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")

Параметры:

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

См. также:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

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

Параметры:: listener — удаляемый слушатель

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

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

Возвращает:: все PropertyChangeListener, которые были добавлены, или пустой массив, если слушатели не добавлялись
Начиная с версии:: 1.4

createDefaultHeaderRenderer

protected TableCellRenderer createDefaultHeaderRenderer()

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

Возвращает:

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

См. также:

© 1993, 2025, 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.