- Java set column size
- Field Summary
- Constructor Summary
- Method Summary
- Methods declared in class java.lang.Object
- Field Detail
- COLUMN_WIDTH_PROPERTY
- HEADER_VALUE_PROPERTY
- HEADER_RENDERER_PROPERTY
- CELL_RENDERER_PROPERTY
- modelIndex
- identifier
- width
- minWidth
- maxWidth
- headerRenderer
- headerValue
- cellRenderer
- cellEditor
- isResizable
- resizedPostingDisableCount
- Constructor Detail
- TableColumn
- TableColumn
- TableColumn
- TableColumn
- Method Detail
- setModelIndex
- getModelIndex
- setIdentifier
- getIdentifier
- setHeaderValue
- getHeaderValue
- setHeaderRenderer
- getHeaderRenderer
- setCellRenderer
- getCellRenderer
- setCellEditor
- getCellEditor
- setWidth
- getWidth
- setPreferredWidth
- getPreferredWidth
- setMinWidth
- getMinWidth
- setMaxWidth
- getMaxWidth
- setResizable
- getResizable
- sizeWidthToFit
- disableResizedPosting
- enableResizedPosting
- addPropertyChangeListener
- removePropertyChangeListener
- getPropertyChangeListeners
- createDefaultHeaderRenderer
Java set column size
A TableColumn represents all the attributes of a column in a JTable , such as width, resizability, 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 JavaBeans™ has been added to the java.beans package. Please see XMLEncoder .
Field Summary
This object is not used internally by the drawing machinery of the JTable ; identifiers may be set in the TableColumn as an optional way to tag and locate table columns.
Constructor Summary
Cover method, using a default model index of 0, default width of 75, a null renderer and a null editor.
Creates and initializes an instance of TableColumn with the specified model index, width, cell renderer, and cell editor; all TableColumn constructors delegate to this one.
Method Summary
Returns an array of all the PropertyChangeListener s added to this TableColumn with addPropertyChangeListener().
Sets the TableColumn ‘s maximum width to maxWidth or, if maxWidth is less than the minimum width, to the minimum width.
Sets the TableColumn ‘s minimum width to minWidth , adjusting the new minimum width if necessary to ensure that 0
This method should not be used to set the widths of columns in the JTable , use setPreferredWidth instead.
Methods declared in class java.lang.Object
Field Detail
COLUMN_WIDTH_PROPERTY
HEADER_VALUE_PROPERTY
HEADER_RENDERER_PROPERTY
CELL_RENDERER_PROPERTY
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.
identifier
This object is not used internally by the drawing machinery of the JTable ; identifiers may be set in the TableColumn 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 .
width
minWidth
maxWidth
headerRenderer
headerValue
cellRenderer
cellEditor
isResizable
protected boolean isResizable
resizedPostingDisableCount
@Deprecated protected transient int resizedPostingDisableCount
This field was not used in previous releases and there are currently no plans to support it in the future.
Constructor Detail
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.
TableColumn
public TableColumn(int modelIndex)
TableColumn
public TableColumn(int modelIndex, int width)
TableColumn
public TableColumn(int modelIndex, int width, TableCellRenderer cellRenderer, TableCellEditor cellEditor)
Creates and initializes an instance of TableColumn with the specified model index, width, cell renderer, and cell editor; all TableColumn constructors delegate to this one. The value of width is used for both the initial and preferred width; if width is negative, they’re set to 0. The minimum width is set to 15 unless the initial width is less, in which case the minimum width is set to the initial width. When the cellRenderer or cellEditor parameter is null , a default value provided by the JTable getDefaultRenderer or getDefaultEditor method, respectively, is 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 JTable .
Method Detail
setModelIndex
@BeanProperty(description="The model index.") public void 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.
getModelIndex
setIdentifier
@BeanProperty(description="A unique identifier for this column.") public void 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.
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.
setHeaderValue
@BeanProperty(description="The text to be used by the header renderer.") public void 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 .
getHeaderValue
setHeaderRenderer
@BeanProperty(description="The header renderer.") public void setHeaderRenderer(TableCellRenderer headerRenderer)
Sets the TableCellRenderer used to draw the TableColumn ‘s header to headerRenderer . It is the header renderers responsibility to render the sorting indicator. If you are using sorting and specify a renderer your renderer must render the sorting indication.
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 .
setCellRenderer
@BeanProperty(description="The renderer to use for cell values.") public void setCellRenderer(TableCellRenderer cellRenderer)
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 .
setCellEditor
@BeanProperty(description="The editor to use for cell values.") public void setCellEditor(TableCellEditor cellEditor)
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 .
setWidth
@BeanProperty(description="The width of the column.") public void 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.
getWidth
setPreferredWidth
@BeanProperty(description="The preferred width of the column.") public void 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 doLayout method in JTable .
getPreferredWidth
public int getPreferredWidth()
setMinWidth
@BeanProperty(description="The minimum width of the column.") public void setMinWidth(int minWidth)
Sets the TableColumn ‘s minimum width to minWidth , adjusting the new minimum width if necessary to ensure that 0
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.
setMaxWidth
@BeanProperty(description="The maximum width of the column.") public void setMaxWidth(int maxWidth)
Sets the TableColumn ‘s maximum width to maxWidth or, if maxWidth is less than the minimum width, to the minimum width. If the value of the width or preferredWidth property is more than the new maximum width, this method sets that property to the new maximum width.
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.
setResizable
@BeanProperty(description="Whether or not this column can be resized.") public void setResizable(boolean isResizable)
getResizable
public boolean 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.
sizeWidthToFit
public void 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). 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.
disableResizedPosting
@Deprecated public void disableResizedPosting()
This field was not used in previous releases and there are currently no plans to support it in the future.
enableResizedPosting
@Deprecated public void enableResizedPosting()
This field was not used in previous releases and there are currently no plans to support it in the future.
addPropertyChangeListener
- this TableColumn’s modelIndex («modelIndex»)
- this TableColumn’s identifier («identifier»)
- this TableColumn’s header value («headerValue»)
- this TableColumn’s header renderer («headerRenderer»)
- this TableColumn’s cell renderer («cellRenderer»)
- this TableColumn’s cell editor («cellEditor»)
- this TableColumn’s width («width»)
- this TableColumn’s preferred width («preferredWidth»)
- this TableColumn’s minimum width («minWidth»)
- this TableColumn’s maximum width («maxWidth»)
- this TableColumn’s resizable state («isResizable»)
removePropertyChangeListener
Removes a PropertyChangeListener from the listener list. The PropertyChangeListener to be removed was registered for all properties.
getPropertyChangeListeners
public PropertyChangeListener[] getPropertyChangeListeners()
Returns an array of all the PropertyChangeListener s added to this TableColumn with addPropertyChangeListener().
createDefaultHeaderRenderer
protected TableCellRenderer 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.
Report a bug or suggest an enhancement
For further API reference and developer documentation see the Java SE Documentation, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples.
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2023, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. Use is subject to license terms and the documentation redistribution policy.