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.
Note: Some implementations may assume that all TableColumnModel
s are unique, therefore we would recommend that the same TableColumn
instance not be added more than once to a TableColumnModel
. To show TableColumn
s with the same column of data from the model, create a new instance with the same modelIndex
.
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. As of 1.4, support for long term storage of all JavaBeansTM has been added to the java.beans
package. Please see java.beans.XMLEncoder.
Détail du champ |
public static final String COLUMN_WIDTH_PROPERTY
public static final String HEADER_VALUE_PROPERTY
public static final String HEADER_RENDERER_PROPERTY
public static final String CELL_RENDERER_PROPERTY
protected int modelIndex
TableColumn
. As columns are moved around in the view modelIndex
remains constant.protected Object identifier
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 identifier objects other than the equals
method which is used in the getColumnIndex()
method in the DefaultTableColumnModel
.protected int width
protected int minWidth
private int preferredWidth
protected int maxWidth
protected TableCellRenderer headerRenderer
protected Object headerValue
protected TableCellRenderer cellRenderer
protected TableCellEditor cellEditor
protected boolean isResizable
protected transient int resizedPostingDisableCount
private SwingPropertyChangeSupport changeSupport
PropertyChangeListeners
have been registered, the changeSupport
field describes them.Détail du constructeur |
public TableColumn()
null
renderer and a null
editor. This method is intended for serialization.public TableColumn(int modelIndex)
null
renderer and a null
editor.public TableColumn(int modelIndex, int width)
null
renderer and a null
editor.public TableColumn(int modelIndex, int width, TableCellRenderer cellRenderer, TableCellEditor cellEditor)
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
. Détail de la méthode |
public void setModelIndex(int modelIndex)
TableColumn
. As the TableColumn
is moved around in the view the model index remains constant.modelIndex
- the new modelIndexpublic int getModelIndex()
modelIndex
propertypublic void setIdentifier(Object identifier)
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.
identifier
- an identifier for this columnpublic Object getIdentifier()
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.identifier
propertypublic void setHeaderValue(Object headerValue)
Object
whose string representation will be used as the value for the headerRenderer
. When the TableColumn
is created, the default headerValue
is null
.headerValue
- the new headerValuepublic Object getHeaderValue()
Object
used as the value for the header renderer.headerValue
propertypublic void setHeaderRenderer(TableCellRenderer headerRenderer)
TableCellRenderer
used to draw the TableColumn
's header to headerRenderer
.headerRenderer
- the new headerRendererpublic TableCellRenderer getHeaderRenderer()
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
.headerRenderer
propertypublic void setCellRenderer(TableCellRenderer cellRenderer)
TableCellRenderer
used by JTable
to draw individual values for this column.cellRenderer
- the new cellRendererpublic TableCellRenderer getCellRenderer()
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
.cellRenderer
propertypublic void setCellEditor(TableCellEditor cellEditor)
cellEditor
- the new cellEditorpublic TableCellEditor getCellEditor()
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
.cellEditor
propertypublic void setWidth(int width)
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.
width
- the new widthpublic int getWidth()
TableColumn
. The default width is 75.width
propertypublic void setPreferredWidth(int preferredWidth)
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
.
preferredWidth
- the new preferred widthpublic int getPreferredWidth()
TableColumn
. The default preferred width is 75.preferredWidth
propertypublic void setMinWidth(int minWidth)
TableColumn
's minimum width to minWidth
; also adjusts the current width and preferred width if they are less than this value.minWidth
- the new minimum widthpublic int getMinWidth()
TableColumn
. The TableColumn
's width can't be made less than this either by the user or programmatically. The default minWidth is 15.minWidth
propertypublic void setMaxWidth(int maxWidth)
TableColumn
's maximum width to maxWidth
; also adjusts the width and preferred width if they are greater than this value.maxWidth
- the new maximum widthpublic int getMaxWidth()
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.maxWidth
propertypublic void setResizable(boolean isResizable)
isResizable
- if true, resizing is allowed; otherwise falsepublic boolean getResizable()
TableColumn
's width, false otherwise. You can change the width programmatically regardless of this setting. The default is true.isResizable
propertypublic void sizeWidthToFit()
TableColumn
to fit the width of its header cell. This method does nothing if the header renderer is null
(the default case). Otherwise, it sets the minimum, maximum and preferred widths of this column to the widths of the minimum, maximum and preferred sizes of the Component delivered by the header renderer. The transient "width" property of this TableColumn is also set to the preferred width. Note this method is not used internally by the table package.public void disableResizedPosting()
public void enableResizedPosting()
public synchronized void addPropertyChangeListener(PropertyChangeListener listener)
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.
listener
- the listener to be addedpublic synchronized void removePropertyChangeListener(PropertyChangeListener listener)
PropertyChangeListener
from the listener list. The PropertyChangeListener
to be removed was registered for all properties.listener
- the listener to be removedpublic synchronized PropertyChangeListener[] getPropertyChangeListeners()
PropertyChangeListener
s added to this TableColumn with addPropertyChangeListener().PropertyChangeListener
s added or an empty array if no listeners have been addedprotected TableCellRenderer createDefaultHeaderRenderer()
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.