You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
826 lines
28 KiB
826 lines
28 KiB
/*
|
|
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
|
|
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*/
|
|
|
|
package javax.swing.table;
|
|
|
|
import javax.swing.*;
|
|
import javax.swing.border.*;
|
|
import javax.swing.event.SwingPropertyChangeSupport;
|
|
import java.lang.Integer;
|
|
import java.awt.Color;
|
|
import java.awt.Component;
|
|
import java.io.Serializable;
|
|
import java.beans.PropertyChangeEvent;
|
|
import java.beans.PropertyChangeListener;
|
|
|
|
/**
|
|
* A <code>TableColumn</code> represents all the attributes of a column in a
|
|
* <code>JTable</code>, such as width, resizability, minimum and maximum width.
|
|
* In addition, the <code>TableColumn</code> provides slots for a renderer and
|
|
* an editor that can be used to display and edit the values in this column.
|
|
* <p>
|
|
* It is also possible to specify renderers and editors on a per type basis
|
|
* rather than a per column basis - see the
|
|
* <code>setDefaultRenderer</code> method in the <code>JTable</code> class.
|
|
* This default mechanism is only used when the renderer (or
|
|
* editor) in the <code>TableColumn</code> is <code>null</code>.
|
|
* <p>
|
|
* The <code>TableColumn</code> stores the link between the columns in the
|
|
* <code>JTable</code> and the columns in the <code>TableModel</code>.
|
|
* The <code>modelIndex</code> is the column in the
|
|
* <code>TableModel</code>, which will be queried for the data values for the
|
|
* cells in this column. As the column moves around in the view this
|
|
* <code>modelIndex</code> does not change.
|
|
* <p>
|
|
* <b>Note:</b> Some implementations may assume that all
|
|
* <code>TableColumnModel</code>s are unique, therefore we would
|
|
* recommend that the same <code>TableColumn</code> instance
|
|
* not be added more than once to a <code>TableColumnModel</code>.
|
|
* To show <code>TableColumn</code>s with the same column of
|
|
* data from the model, create a new instance with the same
|
|
* <code>modelIndex</code>.
|
|
* <p>
|
|
* <strong>Warning:</strong>
|
|
* 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 <code>java.beans</code> package.
|
|
* Please see {@link java.beans.XMLEncoder}.
|
|
*
|
|
* @author Alan Chung
|
|
* @author Philip Milne
|
|
* @see javax.swing.table.TableColumnModel
|
|
*
|
|
* @see javax.swing.table.DefaultTableColumnModel
|
|
* @see javax.swing.table.JTableHeader#getDefaultRenderer()
|
|
* @see JTable#getDefaultRenderer(Class)
|
|
* @see JTable#getDefaultEditor(Class)
|
|
* @see JTable#getCellRenderer(int, int)
|
|
* @see JTable#getCellEditor(int, int)
|
|
*/
|
|
public class TableColumn extends Object implements Serializable {
|
|
|
|
/**
|
|
* Obsolete as of Java 2 platform v1.3. Please use string literals to identify
|
|
* properties.
|
|
*/
|
|
/*
|
|
* Warning: The value of this constant, "columWidth" is wrong as the
|
|
* name of the property is "columnWidth".
|
|
*/
|
|
public final static String COLUMN_WIDTH_PROPERTY = "columWidth";
|
|
|
|
/**
|
|
* Obsolete as of Java 2 platform v1.3. Please use string literals to identify
|
|
* properties.
|
|
*/
|
|
public final static String HEADER_VALUE_PROPERTY = "headerValue";
|
|
|
|
/**
|
|
* Obsolete as of Java 2 platform v1.3. Please use string literals to identify
|
|
* properties.
|
|
*/
|
|
public final static String HEADER_RENDERER_PROPERTY = "headerRenderer";
|
|
|
|
/**
|
|
* Obsolete as of Java 2 platform v1.3. Please use string literals to identify
|
|
* properties.
|
|
*/
|
|
public final static String CELL_RENDERER_PROPERTY = "cellRenderer";
|
|
|
|
//
|
|
// Instance Variables
|
|
//
|
|
|
|
/**
|
|
* The index of the column in the model which is to be displayed by
|
|
* this <code>TableColumn</code>. As columns are moved around in the
|
|
* view <code>modelIndex</code> remains constant.
|
|
*/
|
|
protected int modelIndex;
|
|
|
|
/**
|
|
* This object is not used internally by the drawing machinery of
|
|
* the <code>JTable</code>; identifiers may be set in the
|
|
* <code>TableColumn</code> 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 <code>equals</code> method which is used in the
|
|
* <code>getColumnIndex()</code> method in the
|
|
* <code>DefaultTableColumnModel</code>.
|
|
*/
|
|
protected Object identifier;
|
|
|
|
/** The width of the column. */
|
|
protected int width;
|
|
|
|
/** The minimum width of the column. */
|
|
protected int minWidth;
|
|
|
|
/** The preferred width of the column. */
|
|
private int preferredWidth;
|
|
|
|
/** The maximum width of the column. */
|
|
protected int maxWidth;
|
|
|
|
/** The renderer used to draw the header of the column. */
|
|
protected TableCellRenderer headerRenderer;
|
|
|
|
/** The header value of the column. */
|
|
protected Object headerValue;
|
|
|
|
/** The renderer used to draw the data cells of the column. */
|
|
protected TableCellRenderer cellRenderer;
|
|
|
|
/** The editor used to edit the data cells of the column. */
|
|
protected TableCellEditor cellEditor;
|
|
|
|
/** If true, the user is allowed to resize the column; the default is true. */
|
|
protected boolean isResizable;
|
|
|
|
/**
|
|
* This field was not used in previous releases and there are
|
|
* currently no plans to support it in the future.
|
|
*
|
|
* @deprecated as of Java 2 platform v1.3
|
|
*/
|
|
/*
|
|
* Counter used to disable posting of resizing notifications until the
|
|
* end of the resize.
|
|
*/
|
|
@Deprecated
|
|
transient protected int resizedPostingDisableCount;
|
|
|
|
/**
|
|
* If any <code>PropertyChangeListeners</code> have been registered, the
|
|
* <code>changeSupport</code> field describes them.
|
|
*/
|
|
private SwingPropertyChangeSupport changeSupport;
|
|
|
|
//
|
|
// Constructors
|
|
//
|
|
|
|
/**
|
|
* Cover method, using a default model index of 0,
|
|
* default width of 75, a <code>null</code> renderer and a
|
|
* <code>null</code> editor.
|
|
* This method is intended for serialization.
|
|
* @see #TableColumn(int, int, TableCellRenderer, TableCellEditor)
|
|
*/
|
|
public TableColumn() {
|
|
this(0);
|
|
}
|
|
|
|
/**
|
|
* Cover method, using a default width of 75, a <code>null</code>
|
|
* renderer and a <code>null</code> editor.
|
|
* @see #TableColumn(int, int, TableCellRenderer, TableCellEditor)
|
|
*/
|
|
public TableColumn(int modelIndex) {
|
|
this(modelIndex, 75, null, null);
|
|
}
|
|
|
|
/**
|
|
* Cover method, using a <code>null</code> renderer and a
|
|
* <code>null</code> editor.
|
|
* @see #TableColumn(int, int, TableCellRenderer, TableCellEditor)
|
|
*/
|
|
public TableColumn(int modelIndex, int width) {
|
|
this(modelIndex, width, null, null);
|
|
}
|
|
|
|
/**
|
|
* Creates and initializes an instance of
|
|
* <code>TableColumn</code> with the specified model index,
|
|
* width, cell renderer, and cell editor;
|
|
* all <code>TableColumn</code> constructors delegate to this one.
|
|
* The value of <code>width</code> is used
|
|
* for both the initial and preferred width;
|
|
* if <code>width</code> 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.
|
|
*
|
|
* <p>
|
|
* When the <code>cellRenderer</code>
|
|
* or <code>cellEditor</code> parameter is <code>null</code>,
|
|
* a default value provided by the <code>JTable</code>
|
|
* <code>getDefaultRenderer</code>
|
|
* or <code>getDefaultEditor</code> 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 <code>getCellRenderer</code> methods in <code>JTable</code>.
|
|
*
|
|
* @param modelIndex the index of the column
|
|
* in the model that supplies the data for this column in the table;
|
|
* the model index remains the same
|
|
* even when columns are reordered in the view
|
|
* @param width this column's preferred width and initial width
|
|
* @param cellRenderer the object used to render values in this column
|
|
* @param cellEditor the object used to edit values in this column
|
|
* @see #getMinWidth()
|
|
* @see JTable#getDefaultRenderer(Class)
|
|
* @see JTable#getDefaultEditor(Class)
|
|
* @see JTable#getCellRenderer(int, int)
|
|
* @see JTable#getCellEditor(int, int)
|
|
*/
|
|
public TableColumn(int modelIndex, int width,
|
|
TableCellRenderer cellRenderer,
|
|
TableCellEditor cellEditor) {
|
|
super();
|
|
this.modelIndex = modelIndex;
|
|
preferredWidth = this.width = Math.max(width, 0);
|
|
|
|
this.cellRenderer = cellRenderer;
|
|
this.cellEditor = cellEditor;
|
|
|
|
// Set other instance variables to default values.
|
|
minWidth = Math.min(15, this.width);
|
|
maxWidth = Integer.MAX_VALUE;
|
|
isResizable = true;
|
|
resizedPostingDisableCount = 0;
|
|
headerValue = null;
|
|
}
|
|
|
|
//
|
|
// Modifying and Querying attributes
|
|
//
|
|
|
|
private void firePropertyChange(String propertyName, Object oldValue, Object newValue) {
|
|
if (changeSupport != null) {
|
|
changeSupport.firePropertyChange(propertyName, oldValue, newValue);
|
|
}
|
|
}
|
|
|
|
private void firePropertyChange(String propertyName, int oldValue, int newValue) {
|
|
if (oldValue != newValue) {
|
|
firePropertyChange(propertyName, Integer.valueOf(oldValue), Integer.valueOf(newValue));
|
|
}
|
|
}
|
|
|
|
private void firePropertyChange(String propertyName, boolean oldValue, boolean newValue) {
|
|
if (oldValue != newValue) {
|
|
firePropertyChange(propertyName, Boolean.valueOf(oldValue), Boolean.valueOf(newValue));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 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
|
|
* <code>TableColumn</code>. As the <code>TableColumn</code>
|
|
* is moved around in the view the model index remains constant.
|
|
* @param modelIndex the new modelIndex
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: The model index.
|
|
*/
|
|
public void setModelIndex(int modelIndex) {
|
|
int old = this.modelIndex;
|
|
this.modelIndex = modelIndex;
|
|
firePropertyChange("modelIndex", old, modelIndex);
|
|
}
|
|
|
|
/**
|
|
* Returns the model index for this column.
|
|
* @return the <code>modelIndex</code> property
|
|
*/
|
|
public int getModelIndex() {
|
|
return modelIndex;
|
|
}
|
|
|
|
/**
|
|
* Sets the <code>TableColumn</code>'s identifier to
|
|
* <code>anIdentifier</code>. <p>
|
|
* Note: identifiers are not used by the <code>JTable</code>,
|
|
* they are purely a
|
|
* convenience for the external tagging and location of columns.
|
|
*
|
|
* @param identifier an identifier for this column
|
|
* @see #getIdentifier
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: A unique identifier for this column.
|
|
*/
|
|
public void setIdentifier(Object identifier) {
|
|
Object old = this.identifier;
|
|
this.identifier = identifier;
|
|
firePropertyChange("identifier", old, identifier);
|
|
}
|
|
|
|
|
|
/**
|
|
* Returns the <code>identifier</code> object for this column.
|
|
* Note identifiers are not used by <code>JTable</code>,
|
|
* they are purely a convenience for external use.
|
|
* If the <code>identifier</code> is <code>null</code>,
|
|
* <code>getIdentifier()</code> returns <code>getHeaderValue</code>
|
|
* as a default.
|
|
*
|
|
* @return the <code>identifier</code> property
|
|
* @see #setIdentifier
|
|
*/
|
|
public Object getIdentifier() {
|
|
return (identifier != null) ? identifier : getHeaderValue();
|
|
|
|
}
|
|
|
|
/**
|
|
* Sets the <code>Object</code> whose string representation will be
|
|
* used as the value for the <code>headerRenderer</code>. When the
|
|
* <code>TableColumn</code> is created, the default <code>headerValue</code>
|
|
* is <code>null</code>.
|
|
* @param headerValue the new headerValue
|
|
* @see #getHeaderValue
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: The text to be used by the header renderer.
|
|
*/
|
|
public void setHeaderValue(Object headerValue) {
|
|
Object old = this.headerValue;
|
|
this.headerValue = headerValue;
|
|
firePropertyChange("headerValue", old, headerValue);
|
|
}
|
|
|
|
/**
|
|
* Returns the <code>Object</code> used as the value for the header
|
|
* renderer.
|
|
*
|
|
* @return the <code>headerValue</code> property
|
|
* @see #setHeaderValue
|
|
*/
|
|
public Object getHeaderValue() {
|
|
return headerValue;
|
|
}
|
|
|
|
//
|
|
// Renderers and Editors
|
|
//
|
|
|
|
/**
|
|
* Sets the <code>TableCellRenderer</code> used to draw the
|
|
* <code>TableColumn</code>'s header to <code>headerRenderer</code>.
|
|
* <p>
|
|
* 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.
|
|
*
|
|
* @param headerRenderer the new headerRenderer
|
|
*
|
|
* @see #getHeaderRenderer
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: The header renderer.
|
|
*/
|
|
public void setHeaderRenderer(TableCellRenderer headerRenderer) {
|
|
TableCellRenderer old = this.headerRenderer;
|
|
this.headerRenderer = headerRenderer;
|
|
firePropertyChange("headerRenderer", old, headerRenderer);
|
|
}
|
|
|
|
/**
|
|
* Returns the <code>TableCellRenderer</code> used to draw the header of the
|
|
* <code>TableColumn</code>. When the <code>headerRenderer</code> is
|
|
* <code>null</code>, the <code>JTableHeader</code>
|
|
* uses its <code>defaultRenderer</code>. The default value for a
|
|
* <code>headerRenderer</code> is <code>null</code>.
|
|
*
|
|
* @return the <code>headerRenderer</code> property
|
|
* @see #setHeaderRenderer
|
|
* @see #setHeaderValue
|
|
* @see javax.swing.table.JTableHeader#getDefaultRenderer()
|
|
*/
|
|
public TableCellRenderer getHeaderRenderer() {
|
|
return headerRenderer;
|
|
}
|
|
|
|
/**
|
|
* Sets the <code>TableCellRenderer</code> used by <code>JTable</code>
|
|
* to draw individual values for this column.
|
|
*
|
|
* @param cellRenderer the new cellRenderer
|
|
* @see #getCellRenderer
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: The renderer to use for cell values.
|
|
*/
|
|
public void setCellRenderer(TableCellRenderer cellRenderer) {
|
|
TableCellRenderer old = this.cellRenderer;
|
|
this.cellRenderer = cellRenderer;
|
|
firePropertyChange("cellRenderer", old, cellRenderer);
|
|
}
|
|
|
|
/**
|
|
* Returns the <code>TableCellRenderer</code> used by the
|
|
* <code>JTable</code> to draw
|
|
* values for this column. The <code>cellRenderer</code> of the column
|
|
* not only controls the visual look for the column, but is also used to
|
|
* interpret the value object supplied by the <code>TableModel</code>.
|
|
* When the <code>cellRenderer</code> is <code>null</code>,
|
|
* the <code>JTable</code> uses a default renderer based on the
|
|
* class of the cells in that column. The default value for a
|
|
* <code>cellRenderer</code> is <code>null</code>.
|
|
*
|
|
* @return the <code>cellRenderer</code> property
|
|
* @see #setCellRenderer
|
|
* @see JTable#setDefaultRenderer
|
|
*/
|
|
public TableCellRenderer getCellRenderer() {
|
|
return cellRenderer;
|
|
}
|
|
|
|
/**
|
|
* Sets the editor to used by when a cell in this column is edited.
|
|
*
|
|
* @param cellEditor the new cellEditor
|
|
* @see #getCellEditor
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: The editor to use for cell values.
|
|
*/
|
|
public void setCellEditor(TableCellEditor cellEditor){
|
|
TableCellEditor old = this.cellEditor;
|
|
this.cellEditor = cellEditor;
|
|
firePropertyChange("cellEditor", old, cellEditor);
|
|
}
|
|
|
|
/**
|
|
* Returns the <code>TableCellEditor</code> used by the
|
|
* <code>JTable</code> to edit values for this column. When the
|
|
* <code>cellEditor</code> is <code>null</code>, the <code>JTable</code>
|
|
* uses a default editor based on the
|
|
* class of the cells in that column. The default value for a
|
|
* <code>cellEditor</code> is <code>null</code>.
|
|
*
|
|
* @return the <code>cellEditor</code> property
|
|
* @see #setCellEditor
|
|
* @see JTable#setDefaultEditor
|
|
*/
|
|
public TableCellEditor getCellEditor() {
|
|
return cellEditor;
|
|
}
|
|
|
|
/**
|
|
* This method should not be used to set the widths of columns in the
|
|
* <code>JTable</code>, use <code>setPreferredWidth</code> instead.
|
|
* Like a layout manager in the
|
|
* AWT, the <code>JTable</code> 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.
|
|
* <p>
|
|
* This method sets this column's width to <code>width</code>.
|
|
* If <code>width</code> exceeds the minimum or maximum width,
|
|
* it is adjusted to the appropriate limiting value.
|
|
* @param width the new width
|
|
* @see #getWidth
|
|
* @see #setMinWidth
|
|
* @see #setMaxWidth
|
|
* @see #setPreferredWidth
|
|
* @see JTable#doLayout()
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: The width of the column.
|
|
*/
|
|
public void setWidth(int width) {
|
|
int old = this.width;
|
|
this.width = Math.min(Math.max(width, minWidth), maxWidth);
|
|
firePropertyChange("width", old, this.width);
|
|
}
|
|
|
|
/**
|
|
* Returns the width of the <code>TableColumn</code>. The default width is
|
|
* 75.
|
|
*
|
|
* @return the <code>width</code> property
|
|
* @see #setWidth
|
|
*/
|
|
public int getWidth() {
|
|
return width;
|
|
}
|
|
|
|
/**
|
|
* Sets this column's preferred width to <code>preferredWidth</code>.
|
|
* If <code>preferredWidth</code> exceeds the minimum or maximum width,
|
|
* it is adjusted to the appropriate limiting value.
|
|
* <p>
|
|
* For details on how the widths of columns in the <code>JTable</code>
|
|
* (and <code>JTableHeader</code>) are calculated from the
|
|
* <code>preferredWidth</code>,
|
|
* see the <code>doLayout</code> method in <code>JTable</code>.
|
|
*
|
|
* @param preferredWidth the new preferred width
|
|
* @see #getPreferredWidth
|
|
* @see JTable#doLayout()
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: The preferred width of the column.
|
|
*/
|
|
public void setPreferredWidth(int preferredWidth) {
|
|
int old = this.preferredWidth;
|
|
this.preferredWidth = Math.min(Math.max(preferredWidth, minWidth), maxWidth);
|
|
firePropertyChange("preferredWidth", old, this.preferredWidth);
|
|
}
|
|
|
|
/**
|
|
* Returns the preferred width of the <code>TableColumn</code>.
|
|
* The default preferred width is 75.
|
|
*
|
|
* @return the <code>preferredWidth</code> property
|
|
* @see #setPreferredWidth
|
|
*/
|
|
public int getPreferredWidth() {
|
|
return preferredWidth;
|
|
}
|
|
|
|
/**
|
|
* Sets the <code>TableColumn</code>'s minimum width to
|
|
* <code>minWidth</code>,
|
|
* adjusting the new minimum width if necessary to ensure that
|
|
* 0 <= <code>minWidth</code> <= <code>maxWidth</code>.
|
|
* For example, if the <code>minWidth</code> argument is negative,
|
|
* this method sets the <code>minWidth</code> property to 0.
|
|
*
|
|
* <p>
|
|
* If the value of the
|
|
* <code>width</code> or <code>preferredWidth</code> property
|
|
* is less than the new minimum width,
|
|
* this method sets that property to the new minimum width.
|
|
*
|
|
* @param minWidth the new minimum width
|
|
* @see #getMinWidth
|
|
* @see #setPreferredWidth
|
|
* @see #setMaxWidth
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: The minimum width of the column.
|
|
*/
|
|
public void setMinWidth(int minWidth) {
|
|
int old = this.minWidth;
|
|
this.minWidth = Math.max(Math.min(minWidth, maxWidth), 0);
|
|
if (width < this.minWidth) {
|
|
setWidth(this.minWidth);
|
|
}
|
|
if (preferredWidth < this.minWidth) {
|
|
setPreferredWidth(this.minWidth);
|
|
}
|
|
firePropertyChange("minWidth", old, this.minWidth);
|
|
}
|
|
|
|
/**
|
|
* Returns the minimum width for the <code>TableColumn</code>. The
|
|
* <code>TableColumn</code>'s width can't be made less than this either
|
|
* by the user or programmatically.
|
|
*
|
|
* @return the <code>minWidth</code> property
|
|
* @see #setMinWidth
|
|
* @see #TableColumn(int, int, TableCellRenderer, TableCellEditor)
|
|
*/
|
|
public int getMinWidth() {
|
|
return minWidth;
|
|
}
|
|
|
|
/**
|
|
* Sets the <code>TableColumn</code>'s maximum width to
|
|
* <code>maxWidth</code> or,
|
|
* if <code>maxWidth</code> is less than the minimum width,
|
|
* to the minimum width.
|
|
*
|
|
* <p>
|
|
* If the value of the
|
|
* <code>width</code> or <code>preferredWidth</code> property
|
|
* is more than the new maximum width,
|
|
* this method sets that property to the new maximum width.
|
|
*
|
|
* @param maxWidth the new maximum width
|
|
* @see #getMaxWidth
|
|
* @see #setPreferredWidth
|
|
* @see #setMinWidth
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: The maximum width of the column.
|
|
*/
|
|
public void setMaxWidth(int maxWidth) {
|
|
int old = this.maxWidth;
|
|
this.maxWidth = Math.max(minWidth, maxWidth);
|
|
if (width > this.maxWidth) {
|
|
setWidth(this.maxWidth);
|
|
}
|
|
if (preferredWidth > this.maxWidth) {
|
|
setPreferredWidth(this.maxWidth);
|
|
}
|
|
firePropertyChange("maxWidth", old, this.maxWidth);
|
|
}
|
|
|
|
/**
|
|
* Returns the maximum width for the <code>TableColumn</code>. The
|
|
* <code>TableColumn</code>'s width can't be made larger than this
|
|
* either by the user or programmatically. The default maxWidth
|
|
* is Integer.MAX_VALUE.
|
|
*
|
|
* @return the <code>maxWidth</code> property
|
|
* @see #setMaxWidth
|
|
*/
|
|
public int getMaxWidth() {
|
|
return maxWidth;
|
|
}
|
|
|
|
/**
|
|
* Sets whether this column can be resized.
|
|
*
|
|
* @param isResizable if true, resizing is allowed; otherwise false
|
|
* @see #getResizable
|
|
* @beaninfo
|
|
* bound: true
|
|
* description: Whether or not this column can be resized.
|
|
*/
|
|
public void setResizable(boolean isResizable) {
|
|
boolean old = this.isResizable;
|
|
this.isResizable = isResizable;
|
|
firePropertyChange("isResizable", old, this.isResizable);
|
|
}
|
|
|
|
/**
|
|
* Returns true if the user is allowed to resize the
|
|
* <code>TableColumn</code>'s
|
|
* width, false otherwise. You can change the width programmatically
|
|
* regardless of this setting. The default is true.
|
|
*
|
|
* @return the <code>isResizable</code> property
|
|
* @see #setResizable
|
|
*/
|
|
public boolean getResizable() {
|
|
return isResizable;
|
|
}
|
|
|
|
/**
|
|
* Resizes the <code>TableColumn</code> to fit the width of its header cell.
|
|
* This method does nothing if the header renderer is <code>null</code>
|
|
* (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.
|
|
*
|
|
* @see #setPreferredWidth
|
|
*/
|
|
public void sizeWidthToFit() {
|
|
if (headerRenderer == null) {
|
|
return;
|
|
}
|
|
Component c = headerRenderer.getTableCellRendererComponent(null,
|
|
getHeaderValue(), false, false, 0, 0);
|
|
|
|
setMinWidth(c.getMinimumSize().width);
|
|
setMaxWidth(c.getMaximumSize().width);
|
|
setPreferredWidth(c.getPreferredSize().width);
|
|
|
|
setWidth(getPreferredWidth());
|
|
}
|
|
|
|
/**
|
|
* This field was not used in previous releases and there are
|
|
* currently no plans to support it in the future.
|
|
*
|
|
* @deprecated as of Java 2 platform v1.3
|
|
*/
|
|
@Deprecated
|
|
public void disableResizedPosting() {
|
|
resizedPostingDisableCount++;
|
|
}
|
|
|
|
/**
|
|
* This field was not used in previous releases and there are
|
|
* currently no plans to support it in the future.
|
|
*
|
|
* @deprecated as of Java 2 platform v1.3
|
|
*/
|
|
@Deprecated
|
|
public void enableResizedPosting() {
|
|
resizedPostingDisableCount--;
|
|
}
|
|
|
|
//
|
|
// Property Change Support
|
|
//
|
|
|
|
/**
|
|
* Adds a <code>PropertyChangeListener</code> to the listener list.
|
|
* The listener is registered for all properties.
|
|
* <p>
|
|
* A <code>PropertyChangeEvent</code> will get fired in response to an
|
|
* explicit call to <code>setFont</code>, <code>setBackground</code>,
|
|
* or <code>setForeground</code> 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.
|
|
*
|
|
* @param listener the listener to be added
|
|
*
|
|
*/
|
|
public synchronized void addPropertyChangeListener(
|
|
PropertyChangeListener listener) {
|
|
if (changeSupport == null) {
|
|
changeSupport = new SwingPropertyChangeSupport(this);
|
|
}
|
|
changeSupport.addPropertyChangeListener(listener);
|
|
}
|
|
|
|
/**
|
|
* Removes a <code>PropertyChangeListener</code> from the listener list.
|
|
* The <code>PropertyChangeListener</code> to be removed was registered
|
|
* for all properties.
|
|
*
|
|
* @param listener the listener to be removed
|
|
*
|
|
*/
|
|
|
|
public synchronized void removePropertyChangeListener(
|
|
PropertyChangeListener listener) {
|
|
if (changeSupport != null) {
|
|
changeSupport.removePropertyChangeListener(listener);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns an array of all the <code>PropertyChangeListener</code>s added
|
|
* to this TableColumn with addPropertyChangeListener().
|
|
*
|
|
* @return all of the <code>PropertyChangeListener</code>s added or an empty
|
|
* array if no listeners have been added
|
|
* @since 1.4
|
|
*/
|
|
public synchronized PropertyChangeListener[] getPropertyChangeListeners() {
|
|
if (changeSupport == null) {
|
|
return new PropertyChangeListener[0];
|
|
}
|
|
return changeSupport.getPropertyChangeListeners();
|
|
}
|
|
|
|
//
|
|
// Protected Methods
|
|
//
|
|
|
|
/**
|
|
* As of Java 2 platform v1.3, this method is not called by the <code>TableColumn</code>
|
|
* constructor. Previously this method was used by the
|
|
* <code>TableColumn</code> to create a default header renderer.
|
|
* As of Java 2 platform v1.3, the default header renderer is <code>null</code>.
|
|
* <code>JTableHeader</code> now provides its own shared default
|
|
* renderer, just as the <code>JTable</code> does for its cell renderers.
|
|
*
|
|
* @return the default header renderer
|
|
* @see javax.swing.table.JTableHeader#createDefaultRenderer()
|
|
*/
|
|
protected TableCellRenderer createDefaultHeaderRenderer() {
|
|
DefaultTableCellRenderer label = new DefaultTableCellRenderer() {
|
|
public Component getTableCellRendererComponent(JTable table, Object value,
|
|
boolean isSelected, boolean hasFocus, int row, int column) {
|
|
if (table != null) {
|
|
JTableHeader header = table.getTableHeader();
|
|
if (header != null) {
|
|
setForeground(header.getForeground());
|
|
setBackground(header.getBackground());
|
|
setFont(header.getFont());
|
|
}
|
|
}
|
|
|
|
setText((value == null) ? "" : value.toString());
|
|
setBorder(UIManager.getBorder("TableHeader.cellBorder"));
|
|
return this;
|
|
}
|
|
};
|
|
label.setHorizontalAlignment(JLabel.CENTER);
|
|
return label;
|
|
}
|
|
|
|
} // End of class TableColumn
|