javax.swing.table
Class TableColumn

java.lang.Object
  |
  +--javax.swing.table.TableColumn

All Implemented Interfaces:

Serializable

public class TableColumn

extends Object

implements Serializable

A TableColumn represents all the attributes of a column in a JTable, such as width, resizibility, minimum and maximum width. In addition, the TableColumn provides slots for a renderer and an editor that can be used to display and edit the values in this column.

It is also possible to specify renderers and editors on a per type basis rather than a per column basis - see the setDefaultRenderer method in the JTable class. This default mechanism is only used when the renderer (or editor) in the TableColumn is null.

The TableColumn stores the link between the columns in the JTable and the columns in the TableModel. The modelIndex is the column in the TableModel, which will be queried for the data values for the cells in this column. As the column moves around in the view this modelIndex does not change.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. A future release of Swing will provide support for long term persistence.

See Also:

TableColumnModel, DefaultTableColumnModel, JTableHeader.getDefaultRenderer(), JTable.getDefaultRenderer(Class), JTable.getDefaultEditor(Class), JTable.getCellRenderer(int, int), JTable.getCellEditor(int, int), Serialized Form

Field Summary

static String	CELL_RENDERER_PROPERTY copy-> CELL_RENDERER_PROPERTY Obsolete as of Java 2 platform v1.3. Please use string literals to identify properties.
protected TableCellEditor	cellEditor copy-> cellEditor The editor used to edit the data cells of the column.
protected TableCellRenderer	cellRenderer copy-> cellRenderer The renderer used to draw the data cells of the column.
static String	COLUMN_WIDTH_PROPERTY copy-> COLUMN_WIDTH_PROPERTY Obsolete as of Java 2 platform v1.3. Please use string literals to identify properties.
static String	HEADER_RENDERER_PROPERTY copy-> HEADER_RENDERER_PROPERTY Obsolete as of Java 2 platform v1.3. Please use string literals to identify properties.
static String	HEADER_VALUE_PROPERTY copy-> HEADER_VALUE_PROPERTY Obsolete as of Java 2 platform v1.3. Please use string literals to identify properties.
protected TableCellRenderer	headerRenderer copy-> headerRenderer The renderer used to draw the header of the column.
protected Object	headerValue copy-> headerValue The header value of the column.
protected Object	identifier copy-> identifier This object is not used internally by the drawing machinery of the JTable; identifiers may be set in the TableColumn as as an optional way to tag and locate table columns. The table package does not modify or invoke any methods in these identifer objects other than the equals method which is used in the getColumnIndex() method in the DefaultTableColumnModel.
protected boolean	isResizable copy-> isResizable If true, the user is allowed to resize the column; the default is true.
protected int	maxWidth copy-> maxWidth The maximum width of the column.
protected int	minWidth copy-> minWidth The minimum width of the column.
protected int	modelIndex copy-> modelIndex The index of the column in the model which is to be displayed by this TableColumn. As columns are moved around in the view modelIndex remains constant.
protected int	resizedPostingDisableCount copy-> resizedPostingDisableCount Deprecated. as of Java 2 platform v1.3 This field was not used in previous releases and there are currently no plans to support it in the future.
protected int	width copy-> width The width of the column.

Constructor Summary

TableColumn
copy-> new TableColumn()
copy-> <TableColumn var> = new TableColumn();

Cover method, using a default model index of 0, default width of 75, a null renderer and a null editor. This method is intended for serialization.

See Also:

TableColumn(int, int, TableCellRenderer, TableCellEditor)

TableColumn
copy-> new TableColumn( )
copy-> <TableColumn var> = new TableColumn(<int modelIndex>);

Cover method, using a default width of 75, a null renderer and a null editor.

See Also:

TableColumn(int, int, TableCellRenderer, TableCellEditor)

TableColumn
copy-> new TableColumn(, )
copy-> <TableColumn var> = new TableColumn(<int modelIndex>, <int width>);

Cover method, using a null renderer and a null editor.

See Also:

TableColumn(int, int, TableCellRenderer, TableCellEditor)

TableColumn
copy-> new TableColumn(, , , )
copy-> <TableColumn var> = new TableColumn(<int modelIndex>, <int width>, <TableCellRenderer cellRenderer>, <TableCellEditor cellEditor>);

Creates and initializes an instance of TableColumn with modelIndex. All TableColumn constructors delegate to this one. The modelIndex is the index of the column in the model which will supply the data for this column in the table. The modelIndex does not change as the columns are reordered in the view. The width parameter is used to set both the preferredWidth for this column and the initial width. The renderer and editor are the objects used respectively to render and edit values in this column. When these are null, default values, provided by the getDefaultRenderer and getDefaultEditor methods in the JTable class are used to provide defaults based on the type of the data in this column. This column-centric rendering strategy can be circumvented by overriding the getCellRenderer methods in the JTable.

See Also:

JTable.getDefaultRenderer(Class), JTable.getDefaultEditor(Class), JTable.getCellRenderer(int, int), JTable.getCellEditor(int, int)

Method Summary

void	addPropertyChangeListener(PropertyChangeListener listener) copy-> .addPropertyChangeListener( ) copy-> <TableColumn>.addPropertyChangeListener(<PropertyChangeListener listener>); Adds a PropertyChangeListener to the listener list. The listener is registered for all properties. A PropertyChangeEvent will get fired in response to an explicit call to setFont, setBackground, or setForeground on the current component. Note that if the current component is inheriting its foreground, background, or font from its container, then no event will be fired in response to a change in the inherited property. Parameters: listener - the listener to be added
protected TableCellRenderer	createDefaultHeaderRenderer() copy-> .createDefaultHeaderRenderer() copy-> <TableCellRenderer var>=<TableColumn>.createDefaultHeaderRenderer(); As of Java 2 platform v1.3, this method is not called by the TableColumn constructor. Previously this method was used by the TableColumn to create a default header renderer. As of Java 2 platform v1.3, the default header renderer is null. JTableHeader now provides its own shared default renderer, just as the JTable does for its cell renderers. Returns: the default header renderer See Also: JTableHeader.createDefaultRenderer()
void	disableResizedPosting() copy-> .disableResizedPosting() copy-> <TableColumn>.disableResizedPosting(); Deprecated. as of Java 2 platform v1.3 This field was not used in previous releases and there are currently no plans to support it in the future.
void	enableResizedPosting() copy-> .enableResizedPosting() copy-> <TableColumn>.enableResizedPosting(); Deprecated. as of Java 2 platform v1.3 This field was not used in previous releases and there are currently no plans to support it in the future.
TableCellEditor	getCellEditor() copy-> .getCellEditor() copy-> <TableCellEditor var>=<TableColumn>.getCellEditor(); Returns the TableCellEditor used by the JTable to edit values for this column. When the cellEditor is null, the JTable uses a default editor based on the class of the cells in that column. The default value for a cellEditor is null. Returns: the cellEditor property See Also: setCellEditor(javax.swing.table.TableCellEditor), JTable.setDefaultEditor(java.lang.Class, javax.swing.table.TableCellEditor)
TableCellRenderer	getCellRenderer() copy-> .getCellRenderer() copy-> <TableCellRenderer var>=<TableColumn>.getCellRenderer(); Returns the TableCellRenderer used by the JTable to draw values for this column. The cellRenderer of the column not only controls the visual look for the column, but is also used to interpret the value object supplied by the TableModel. When the cellRenderer is null, the JTable uses a default renderer based on the class of the cells in that column. The default value for a cellRenderer is null. Returns: the cellRenderer property See Also: setCellRenderer(javax.swing.table.TableCellRenderer), JTable.setDefaultRenderer(java.lang.Class, javax.swing.table.TableCellRenderer)
TableCellRenderer	getHeaderRenderer() copy-> .getHeaderRenderer() copy-> <TableCellRenderer var>=<TableColumn>.getHeaderRenderer(); Returns the TableCellRenderer used to draw the header of the TableColumn. When the headerRenderer is null, the JTableHeader uses its defaultRenderer. The default value for a headerRenderer is null. Returns: the headerRenderer property See Also: setHeaderRenderer(javax.swing.table.TableCellRenderer), setHeaderValue(java.lang.Object), JTableHeader.getDefaultRenderer()
Object	getHeaderValue() copy-> .getHeaderValue() copy-> <Object var>=<TableColumn>.getHeaderValue(); Returns the Object used as the value for the header renderer. Returns: the headerValue property See Also: setHeaderValue(java.lang.Object)
Object	getIdentifier() copy-> .getIdentifier() copy-> <Object var>=<TableColumn>.getIdentifier(); Returns the identifier object for this column. Note identifiers are not used by JTable, they are purely a convenience for external use. If the identifier is null, getIdentifier() returns getHeaderValue as a default. Returns: the identifier property See Also: setIdentifier(java.lang.Object)
int	getMaxWidth() copy-> .getMaxWidth() copy-> <int var>=<TableColumn>.getMaxWidth(); Returns the maximum width for the TableColumn. The TableColumn's width can't be made larger than this either by the user or programmatically. The default maxWidth is Integer.MAX_VALUE. Returns: the maxWidth property See Also: setMaxWidth(int)
int	getMinWidth() copy-> .getMinWidth() copy-> <int var>=<TableColumn>.getMinWidth(); Returns the minimum width for the TableColumn. The TableColumn's width can't be made less than this either by the user or programmatically. The default minWidth is 15. Returns: the minWidth property See Also: setMinWidth(int)
int	getModelIndex() copy-> .getModelIndex() copy-> <int var>=<TableColumn>.getModelIndex(); Returns the model index for this column. Returns: the modelIndex property
int	getPreferredWidth() copy-> .getPreferredWidth() copy-> <int var>=<TableColumn>.getPreferredWidth(); Returns the preferred width of the TableColumn. The default preferred width is 75. Returns: the preferredWidth property See Also: setPreferredWidth(int)
boolean	getResizable() copy-> .getResizable() copy-> <boolean var>=<TableColumn>.getResizable(); Returns true if the user is allowed to resize the TableColumn's width, false otherwise. You can change the width programmatically regardless of this setting. The default is true. Returns: the isResizable property See Also: setResizable(boolean)
int	getWidth() copy-> .getWidth() copy-> <int var>=<TableColumn>.getWidth(); Returns the width of the TableColumn. The default width is 75. Returns: the width property See Also: setWidth(int)
void	removePropertyChangeListener(PropertyChangeListener listener) copy-> .removePropertyChangeListener( ) copy-> <TableColumn>.removePropertyChangeListener(<PropertyChangeListener listener>); Removes a PropertyChangeListener from the listener list. The PropertyChangeListener to be removed was registered for all properties. Parameters: listener - the listener to be removed
void	setCellEditor(TableCellEditor cellEditor) copy-> .setCellEditor( ) copy-> <TableColumn>.setCellEditor(<TableCellEditor cellEditor>); Sets the editor to used by when a cell in this column is edited. Parameters: cellEditor - the new cellEditor See Also: getCellEditor()
void	setCellRenderer(TableCellRenderer cellRenderer) copy-> .setCellRenderer( ) copy-> <TableColumn>.setCellRenderer(<TableCellRenderer cellRenderer>); Sets the TableCellRenderer used by JTable to draw individual values for this column. Parameters: cellRenderer - the new cellRenderer See Also: getCellRenderer()
void	setHeaderRenderer(TableCellRenderer headerRenderer) copy-> .setHeaderRenderer( ) copy-> <TableColumn>.setHeaderRenderer(<TableCellRenderer headerRenderer>); Sets the TableCellRenderer used to draw the TableColumn's header to headerRenderer. Parameters: headerRenderer - the new headerRenderer See Also: getHeaderRenderer()
void	setHeaderValue(Object headerValue) copy-> .setHeaderValue( ) copy-> <TableColumn>.setHeaderValue(<Object headerValue>); Sets the Object whose string representation will be used as the value for the headerRenderer. When the TableColumn is created, the default headerValue is null. Parameters: headerValue - the new headerValue See Also: getHeaderValue()
void	setIdentifier(Object identifier) copy-> .setIdentifier( ) copy-> <TableColumn>.setIdentifier(<Object identifier>); Sets the TableColumn's identifier to anIdentifier. Note: identifiers are not used by the JTable, they are purely a convenience for the external tagging and location of columns. Parameters: identifier - an identifier for this column See Also: getIdentifier()
void	setMaxWidth(int maxWidth) copy-> .setMaxWidth( ) copy-> <TableColumn>.setMaxWidth(<int maxWidth>); Sets the TableColumn's maximum width to maxWidth; also adjusts the width and preferred width if they are greater than this value. Parameters: maxWidth - the new maximum width See Also: getMaxWidth(), setPreferredWidth(int), setMinWidth(int)
void	setMinWidth(int minWidth) copy-> .setMinWidth( ) copy-> <TableColumn>.setMinWidth(<int minWidth>); Sets the TableColumn's minimum width to minWidth; also adjusts the current width and preferred width if they are less than this value. Parameters: minWidth - the new minimum width See Also: getMinWidth(), setPreferredWidth(int), setMaxWidth(int)
void	setModelIndex(int modelIndex) copy-> .setModelIndex( ) copy-> <TableColumn>.setModelIndex(<int modelIndex>); Sets the model index for this column. The model index is the index of the column in the model that will be displayed by this TableColumn. As the TableColumn is moved around in the view the model index remains constant. Parameters: modelIndex - the new modelIndex
void	setPreferredWidth(int preferredWidth) copy-> .setPreferredWidth( ) copy-> <TableColumn>.setPreferredWidth(<int preferredWidth>); Sets this column's preferred width to preferredWidth. If preferredWidth exceeds the minimum or maximum width, it is adjusted to the appropriate limiting value. For details on how the widths of columns in the JTable (and JTableHeader) are calculated from the preferredWidth, see the sizeColumnsToFit method in JTable. Parameters: preferredWidth - the new preferred width See Also: getPreferredWidth(), JTable.sizeColumnsToFit(int)
void	setResizable(boolean isResizable) copy-> .setResizable( ) copy-> <TableColumn>.setResizable(<boolean isResizable>); Sets whether this column can be resized. Parameters: isResizable - if true, resizing is allowed; otherwise false See Also: getResizable()
void	setWidth(int width) copy-> .setWidth( ) copy-> <TableColumn>.setWidth(<int width>); This method should not be used to set the widths of columns in the JTable, use setPreferredWidth instead. Like a layout manager in the AWT, the JTable adjusts a column's width automatically whenever the table itself changes size, or a column's preferred width is changed. Setting widths programmatically therefore has no long term effect. This method sets this column's width to width. If width exceeds the minimum or maximum width, it is adjusted to the appropriate limiting value. Parameters: width - the new width See Also: getWidth(), setMinWidth(int), setMaxWidth(int), setPreferredWidth(int), JTable.sizeColumnsToFit(int)
void	sizeWidthToFit() copy-> .sizeWidthToFit() copy-> <TableColumn>.sizeWidthToFit(); Resizes the TableColumn to fit the width of its header cell. This method does nothing if the header renderer is null (the default case). See Also: setPreferredWidth(int)

Methods inherited from class java.lang.Object

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