Class TableColumn

public static final String CELL_RENDERER_PROPERTY

The name for the cellRenderer property.

Field Value:

"cellRenderer"

public static final String COLUMN_WIDTH_PROPERTY

The name for the columnWidth property (this field is obsolete and no longer used). Note also that the typo in the value string is deliberate, to match the specification.

Field Value:

"columWidth"

public static final String HEADER_RENDERER_PROPERTY

The name for the headerRenderer property.

Field Value:

"headerRenderer"

public static final String HEADER_VALUE_PROPERTY

The name for the headerValue property.

Field Value:

"headerValue"

protected TableCellEditor cellEditor

An editor for the regular cells in this column.

protected TableCellRenderer cellRenderer

The renderer for the regular cells in this column.

protected TableCellRenderer headerRenderer

The renderer for the column header.

protected Object headerValue

The value for the column header.

protected Object identifier

The identifier for the column.

protected boolean isResizable

A flag that determines whether or not the column is resizable (the default is true).

protected int maxWidth

The maximum width for the column.

protected int minWidth

The minimum width for the column.

protected int modelIndex

The index of the corresponding column in the table model.

protected int resizedPostingDisableCount

Deprecated. 1.3

resizedPostingDisableCount

protected int width

The current width for the column.

public TableColumn()

Creates a new TableColumn that maps to column 0 in the related table model. The default width is 75 units.

public TableColumn(int modelIndex)

Creates a new TableColumn that maps to the specified column in the related table model. The default width is 75 units.

Parameters:

modelIndex - the index of the column in the model

public TableColumn(int modelIndex,
                   int width)

Creates a new TableColumn that maps to the specified column in the related table model, and has the specified width.

Parameters:

modelIndex - the index of the column in the model

width - the width

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

Creates a new TableColumn that maps to the specified column in the related table model, and has the specified width, cellRenderer and cellEditor.

Parameters:

modelIndex - the index of the column in the model

width - the width

cellRenderer - the cell renderer (null permitted).

cellEditor - the cell editor (null permitted).

public void addPropertyChangeListener(PropertyChangeListener listener)

Adds a listener so that it receives PropertyChangeEvent notifications from this column. The properties defined by the column are:

• width - see setWidth(int);
• preferredWidth - see setPreferredWidth(int);
• minWidth - see setMinWidth(int);
• maxWidth - see setMaxWidth(int);
• modelIndex - see setModelIndex(int);
• isResizable - see setResizable(boolean);
• cellRenderer - see setCellRenderer(TableCellRenderer);
• cellEditor - see setCellEditor(TableCellEditor);
• headerRenderer - see setHeaderRenderer(TableCellRenderer);
• headerValue - see setHeaderValue(Object);
• identifier - see setIdentifier(Object).

Parameters:

listener - the listener to add (null is ignored).

See Also:

removePropertyChangeListener(PropertyChangeListener)

protected TableCellRenderer createDefaultHeaderRenderer()

Creates and returns a default renderer for the column header (in this case, a new instance of DefaultTableCellRenderer).

Returns:

A default renderer for the column header.

public void disableResizedPosting()

Deprecated. 1.3

This method is empty, unused and deprecated.

public void enableResizedPosting()

Deprecated. 1.3

This method is empty, unused and deprecated.

public TableCellEditor getCellEditor()

Returns the cell editor for the column (the default value is null).

Returns:

The cell editor (possibly null).

See Also:

setCellEditor(TableCellEditor)

public TableCellRenderer getCellRenderer()

Returns the renderer for the table cells in this column.

Returns:

The cell renderer (possibly null).

See Also:

setCellRenderer(TableCellRenderer)

public TableCellRenderer getHeaderRenderer()

Returns the renderer for the column header.

Returns:

The renderer for the column header (possibly null).

See Also:

setHeaderRenderer(TableCellRenderer)

public Object getHeaderValue()

Returns the header value.

Returns:

the value of the header.

See Also:

getHeaderValue()

public Object getIdentifier()

Returns the identifier for the column, or getHeaderValue() if the identifier is null.

Returns:

The identifier (or getHeaderValue() if the identifier is null).

public int getMaxWidth()

Returns the maximum width for the column (the default value is Integer.MAX_VALUE).

Returns:

The maximum width for the column.

See Also:

setMaxWidth(int)

public int getMinWidth()

Returns the TableColumn's minimum width (the default value is 15).

Returns:

The minimum width.

See Also:

setMinWidth(int)

public int getModelIndex()

Returns the index of the column in the related TableModel that this TableColumn maps to.

Returns:

the model index.

See Also:

setModelIndex(int)

public int getPreferredWidth()

Returns the preferred width for the column (the default value is 75).

Returns:

The preferred width.

See Also:

setPreferredWidth(int)

public PropertyChangeListener[] getPropertyChangeListeners()

Returns the property change listeners for this TableColumn. An empty array is returned if there are currently no listeners registered.

Returns:

The property change listeners registered with this column.

Since:

1.4

public boolean getResizable()

Returns the flag that controls whether or not the column is resizable.

Returns:

true if this column is resizable, false otherwise.

See Also:

setResizable(boolean)

public int getWidth()

Returns the width for the column (the default value is 75).

Returns:

The width.

See Also:

setWidth(int)

public void removePropertyChangeListener(PropertyChangeListener listener)

Removes a listener so that it no longer receives PropertyChangeEvent notifications from this column. If listener is not registered with the column, or is null, this method does nothing.

Parameters:

listener - the listener to remove (null is ignored).

public void setCellEditor(TableCellEditor cellEditor)

Sets the cell editor for the column and sends a PropertyChangeEvent (with the property name 'cellEditor') to all registered listeners.

Parameters:

cellEditor - the cell editor (null permitted).

See Also:

getCellEditor()

public void setCellRenderer(TableCellRenderer renderer)

Sets the renderer for cells in this column and sends a PropertyChangeEvent (with the property name CELL_RENDERER_PROPERTY) to all registered listeners.

Parameters:

renderer - the cell renderer (null permitted).

See Also:

getCellRenderer()

public void setHeaderRenderer(TableCellRenderer renderer)

Sets the renderer for the column header and sends a PropertyChangeEvent (with the property name HEADER_RENDERER_PROPERTY) to all registered listeners.

Parameters:

renderer - the header renderer (null permitted).

See Also:

getHeaderRenderer()

public void setHeaderValue(Object headerValue)

Sets the header value and sends a PropertyChangeEvent (with the property name HEADER_VALUE_PROPERTY) to all registered listeners.

Parameters:

headerValue - the value of the header (null permitted).

See Also:

getHeaderValue()

public void setIdentifier(Object identifier)

Sets the identifier for the column and sends a PropertyChangeEvent (with the property name 'identifier') to all registered listeners.

Parameters:

identifier - the identifier (null permitted).

See Also:

getIdentifier()

public void setMaxWidth(int maxWidth)

Sets the maximum width for the column and sends a PropertyChangeEvent (with the property name 'maxWidth') to all registered listeners. If the current width and/or preferredWidth are greater than the new maximum width, they are adjusted accordingly.

Parameters:

maxWidth - the maximum width.

See Also:

getMaxWidth()

public void setMinWidth(int minWidth)

Sets the minimum width for the column and sends a PropertyChangeEvent (with the property name 'minWidth') to all registered listeners. If the current width and/or preferredWidth are less than the new minimum width, they are adjusted accordingly.

Parameters:

minWidth - the minimum width (negative values are treated as 0).

See Also:

getMinWidth()

public void setModelIndex(int modelIndex)

Sets the index of the column in the related TableModel that this TableColumn maps to, and sends a PropertyChangeEvent (with the property name 'modelIndex') to all registered listeners.

Parameters:

modelIndex - the column index in the model.

See Also:

getModelIndex()

public void setPreferredWidth(int preferredWidth)

Sets the preferred width for the column and sends a PropertyChangeEvent (with the property name 'preferredWidth') to all registered listeners. If necessary, the supplied value will be adjusted to fit in the range getMinWidth() to getMaxWidth().

Parameters:

preferredWidth - the preferred width.

See Also:

getPreferredWidth()

public void setResizable(boolean isResizable)

Sets the flag that controls whether or not the column is resizable, and sends a PropertyChangeEvent (with the property name 'isResizable') to all registered listeners.

Parameters:

isResizable - true if this column is resizable, false otherwise.

See Also:

getResizable()

public void setWidth(int newWidth)

Sets the width for the column and sends a PropertyChangeEvent (with the property name 'width') to all registered listeners. If the new width falls outside the range getMinWidth() to getMaxWidth() it is adjusted to the appropriate boundary value.

Parameters:

newWidth - the width.

See Also:

getWidth()

public void sizeWidthToFit()

Sets the minimum, maximum, preferred and current width to match the minimum, maximum and preferred width of the header renderer component. If there is no header renderer component, this method does nothing.