i, automatically change only the
* single column i+1 to provide or absorb excess space
* requirements.
*/
public static final int AUTO_RESIZE_NEXT_COLUMN = 1;
/**
* When resizing column i in a table of n
* columns, automatically change all columns in the range [i+1,
* n), uniformly, to provide or absorb excess space requirements.
*/
public static final int AUTO_RESIZE_SUBSEQUENT_COLUMNS = 2;
/**
* When resizing column i in a table of n
* columns, automatically change all columns in the range [0,
* n) (with the exception of column i) uniformly, to provide or
* absorb excess space requirements.
*/
public static final int AUTO_RESIZE_ALL_COLUMNS = 4;
/**
* When resizing column i in a table of n
* columns, automatically change column n-1 (the last column
* in the table) to provide or absorb excess space requirements.
*/
public static final int AUTO_RESIZE_LAST_COLUMN = 3;
/**
* A table mapping {@link java.lang.Class} objects to
* {@link TableCellEditor} objects. This table is consulted by the
* FIXME
*/
protected Hashtable defaultEditorsByColumnClass;
/**
* A table mapping {@link java.lang.Class} objects to
* {@link TableCellEditor} objects. This table is consulted by the
* FIXME
*/
protected Hashtable defaultRenderersByColumnClass;
/**
* The column that is edited, -1 if the table is not edited currently.
*/
protected int editingColumn;
/**
* The row that is edited, -1 if the table is not edited currently.
*/
protected int editingRow;
/**
* The component that is used for editing.
* null if the table is not editing currently.
*
*/
protected transient Component editorComp;
/**
* Whether or not the table should automatically compute a matching
* {@link TableColumnModel} and assign it to the {@link #columnModel}
* property when the {@link #dataModel} property is changed.
*
* @see #setModel()
* @see #createColumnsFromModel()
* @see #setColumnModel()
* @see #setAutoCreateColumnsFromModel()
* @see #getAutoCreateColumnsFromModel()
*/
protected boolean autoCreateColumnsFromModel;
/**
* A numeric code specifying the resizing behavior of the table. Must be
* one of {@link #AUTO_RESIZE_ALL_COLUMNS} (the default), {@link
* #AUTO_RESIZE_LAST_COLUMN}, {@link #AUTO_RESIZE_NEXT_COLUMN}, {@link
* #AUTO_RESIZE_SUBSEQUENT_COLUMNS}, or {@link #AUTO_RESIZE_OFF}.
*
* @see #doLayout()
* @see #setAutoResizeMode()
* @see #getAutoResizeMode()
*/
protected int autoResizeMode;
/**
* The height in pixels of any row of the table. All rows in a table are
* of uniform height. This differs from column width, which varies on a
* per-column basis, and is stored in the individual columns of the
* {@link #columnModel}.
*
* @see #getRowHeight()
* @see #setRowHeight()
* @see TableColumn#getWidth()
* @see TableColumn#setWidth()
*/
protected int rowHeight;
/**
* The height in pixels of the gap left between any two rows of the table.
*
* @see #setRowMargin()
* @see #getRowHeight()
* @see #getIntercellSpacing()
* @see #setIntercellSpacing()
* @see TableColumnModel#getColumnMargin()
* @see TableColumnModel#setColumnMargin()
*/
protected int rowMargin;
/**
* Whether or not the table should allow row selection. If the table
* allows both row and column selection, it is said to allow
* "cell selection". Previous versions of the JDK supported cell
* selection as an independent concept, but it is now represented solely
* in terms of simultaneous row and column selection.
*
* @see TableColumnModel#columnSelectionAllowed()
* @see #setRowSelectionAllowed()
* @see #getRowSelectionAllowed()
* @see #getCellSelectionEnabled()
* @see #setCellSelectionEnabled()
*/
protected boolean rowSelectionAllowed;
/**
* @deprecated Use {@link #rowSelectionAllowed}, {@link
* #columnSelectionAllowed}, or the combined methods {@link
* getCellSelectionEnabled} and {@link setCellSelectionEnabled}.
*/
protected boolean cellSelectionEnabled;
/**
* The model for data stored in the table. Confusingly, the published API
* requires that this field be called dataModel, despite its
* property name. The table listens to its model as a {@link
* TableModelListener}.
*
* @see #tableChanged()
* @see TableModel#addTableModelListener()
*/
protected TableModel dataModel;
/**
* A model of various aspects of the columns of the table, not * including the data stored in them. The {@link TableColumnModel} * is principally concerned with holding a set of {@link TableColumn} * objects, each of which describes the display parameters of a column * and the numeric index of the column from the data model which the * column is presenting.
* *The TableColumnModel also contains a {@link ListSelectionModel} which * indicates which columns are currently selected. This selection model * works in combination with the {@link selectionModel} of the table * itself to specify a table selection: a combination of row and * column selections.
* *Most application programmers do not need to work with this property * at all: setting {@link #autoCreateColumnsFromModel} will construct the * columnModel automatically, and the table acts as a facade for most of * the interesting properties of the columnModel anyways.
* * @see #setColumnModel() * @see #getColumnModel() */ protected TableColumnModel columnModel; /** * A model of the rows of this table which are currently selected. This * model is used in combination with the column selection model held as a * member of the {@link columnModel} property, to represent the rows and * columns (or both: cells) of the table which are currently selected. * * @see #rowSelectionAllowed * @see #setSelectionModel() * @see #getSelectionModel() * @see TableColumnModel#getSelectionModel() * @see ListSelectionModel#addListSelectionListener() */ protected ListSelectionModel selectionModel; /** * The accessibleContext property. */ protected AccessibleContext accessibleContext; /** * The current cell editor. */ protected TableCellEditor cellEditor; /** * Whether or not drag-and-drop is enabled on this table. * * @see #setDragEnabled() * @see #getDragEnabled() */ private boolean dragEnabled; /** * The color to paint the grid lines of the table, when either {@link * #showHorizontalLines} or {@link #showVerticalLines} is set. * * @see #setGridColor() * @see #getGridColor() */ protected Color gridColor; /** * The size this table would prefer its viewport assume, if it is * contained in a {@link JScrollPane}. * * @see #setPreferredScrollableViewportSize() * @see #getPreferredScrollableViewportSize() */ protected Dimension preferredViewportSize; /** * The color to paint the background of selected cells. Fires a property * change event with name {@link #SELECTION_BACKGROUND_CHANGED_PROPERTY} * when its value changes. * * @see #setSelectionBackground() * @see #getSelectionBackground() */ protected Color selectionBackground; /** * The name carried in property change events when the {@link * #selectionBackground} property changes. */ private static final String SELECTION_BACKGROUND_CHANGED_PROPERTY = "selectionBackground"; /** * The color to paint the foreground of selected cells. Fires a property * change event with name {@link #SELECTION_FOREGROUND_CHANGED_PROPERTY} * when its value changes. * * @see #setSelectionForeground() * @see #getSelectionForeground() */ protected Color selectionForeground; /** * The name carried in property change events when the * {@link #selectionForeground} property changes. */ private static final String SELECTION_FOREGROUND_CHANGED_PROPERTY = "selectionForeground"; /** * The showHorizontalLines property. */ protected boolean showHorizontalLines; /** * The showVerticalLines property. */ protected boolean showVerticalLines; /** * The tableHeader property. */ protected JTableHeader tableHeader; /** * Creates a newJTable instance.
*/
public JTable ()
{
this(null, null, null);
}
/**
* Creates a new JTable instance.
*
* @param numRows an int value
* @param numColumns an int value
*/
public JTable (int numRows, int numColumns)
{
this(new DefaultTableModel(numRows, numColumns));
}
/**
* Creates a new JTable instance.
*
* @param data an Object[][] value
* @param columnNames an Object[] value
*/
public JTable(Object[][] data, Object[] columnNames)
{
this(new DefaultTableModel(data, columnNames));
}
/**
* Creates a new JTable instance.
*
* @param dm a TableModel value
*/
public JTable (TableModel dm)
{
this(dm, null, null);
}
/**
* Creates a new JTable instance.
*
* @param dm a TableModel value
* @param cm a TableColumnModel value
*/
public JTable (TableModel dm, TableColumnModel cm)
{
this(dm, cm, null);
}
/**
* Creates a new JTable instance.
*
* @param dm a TableModel value
* @param cm a TableColumnModel value
* @param sm a ListSelectionModel value
*/
public JTable (TableModel dm, TableColumnModel cm, ListSelectionModel sm)
{
this.dataModel = dm == null ? createDefaultDataModel() : dm;
setSelectionModel(sm == null ? createDefaultSelectionModel() : sm);
this.columnModel = cm;
initializeLocalVars();
updateUI();
}
protected void initializeLocalVars()
{
this.autoCreateColumnsFromModel = false;
if (columnModel == null)
{
this.autoCreateColumnsFromModel = true;
createColumnsFromModel();
}
this.columnModel.addColumnModelListener(this);
this.defaultRenderersByColumnClass = new Hashtable();
createDefaultRenderers();
this.defaultEditorsByColumnClass = new Hashtable();
createDefaultEditors();
this.autoResizeMode = AUTO_RESIZE_ALL_COLUMNS;
this.rowHeight = 16;
this.rowMargin = 1;
this.rowSelectionAllowed = true;
// this.accessibleContext = new AccessibleJTable();
this.cellEditor = null;
this.dragEnabled = false;
this.preferredViewportSize = new Dimension(450,400);
this.showHorizontalLines = true;
this.showVerticalLines = true;
this.editingColumn = -1;
this.editingRow = -1;
setIntercellSpacing(new Dimension(1,1));
setTableHeader(createDefaultTableHeader());
}
/**
* Creates a new JTable instance.
*
* @param data a Vector value
* @param columnNames a Vector value
*/
public JTable(Vector data, Vector columnNames)
{
this(new DefaultTableModel(data, columnNames));
}
public void addColumn(TableColumn column)
{
if (column.getHeaderValue() == null)
{
String name = getColumnName(column.getModelIndex());
column.setHeaderValue(name);
}
columnModel.addColumn(column);
}
protected void createDefaultEditors()
{
//FIXME: Create the editor object.
}
protected void createDefaultRenderers()
{
//FIXME: Create the renderer object.
}
/**
* @deprecated 1.0.2, replaced by new JScrollPane(JTable)
*/
public static JScrollPane createScrollPaneForTable(JTable table)
{
return new JScrollPane(table);
}
protected TableColumnModel createDefaultColumnModel()
{
return new DefaultTableColumnModel();
}
protected TableModel createDefaultDataModel()
{
return new DefaultTableModel();
}
protected ListSelectionModel createDefaultSelectionModel()
{
return new DefaultListSelectionModel();
}
protected JTableHeader createDefaultTableHeader()
{
return new JTableHeader(columnModel);
}
private void createColumnsFromModel()
{
if (dataModel == null)
return;
TableColumnModel cm = createDefaultColumnModel();
for (int i = 0; i < dataModel.getColumnCount(); ++i)
{
cm.addColumn(new TableColumn(i));
}
this.setColumnModel(cm);
}
// listener support
public void columnAdded (TableColumnModelEvent event)
{
revalidate();
repaint();
}
public void columnMarginChanged (ChangeEvent event)
{
revalidate();
repaint();
}
public void columnMoved (TableColumnModelEvent event)
{
revalidate();
repaint();
}
public void columnRemoved (TableColumnModelEvent event)
{
revalidate();
repaint();
}
public void columnSelectionChanged (ListSelectionEvent event)
{
repaint();
}
public void editingCanceled (ChangeEvent event)
{
repaint();
}
public void editingStopped (ChangeEvent event)
{
repaint();
}
public void tableChanged (TableModelEvent event)
{
repaint();
}
public void valueChanged (ListSelectionEvent event)
{
repaint();
}
/**
* Returns index of the column that contains specified point
* or -1 if this table doesn't contain this point.
*
* @param point point to identify the column
* @return index of the column that contains specified point or
* -1 if this table doesn't contain this point.
*/
public int columnAtPoint(Point point)
{
int x0 = getLocation().x;
int ncols = getColumnCount();
Dimension gap = getIntercellSpacing();
TableColumnModel cols = getColumnModel();
int x = point.x;
for (int i = 0; i < ncols; ++i)
{
int width = cols.getColumn(i).getWidth() + (gap == null ? 0 : gap.width);
if (0 <= x && x < width)
return i;
x -= width;
}
return -1;
}
/**
* Returns index of the row that contains specified point or
* -1 if this table doesn't contain this point.
*
* @param point point to identify the row
* @return index of the row that contains specified point or
* -1 if this table doesn't contain this point.
*/
public int rowAtPoint(Point point)
{
int y0 = getLocation().y;
int nrows = getRowCount();
Dimension gap = getIntercellSpacing();
int height = getRowHeight() + (gap == null ? 0 : gap.height);
int y = point.y;
for (int i = 0; i < nrows; ++i)
{
if (0 <= y && y < height)
return i;
y -= height;
}
return -1;
}
/**
* Calculate the visible rectangle for a particular row and column. The
* row and column are specified in visual terms; the column may not match
* the {@link #dataModel} column.
*
* @param row the visible row to get the cell rectangle of
*
* @param column the visible column to get the cell rectangle of, which may
* differ from the {@link #dataModel} column
*
* @param includeSpacing whether or not to include the cell margins in the
* resulting cell. If false, the result will only contain the
* inner area of the target cell, not including its margins.
*
* @return a rectangle enclosing the specified cell
*/
public Rectangle getCellRect(int row,
int column,
boolean includeSpacing)
{
int height = getHeight();
int width = columnModel.getColumn(column).getWidth();
int x_gap = columnModel.getColumnMargin();
int y_gap = rowMargin;
column = Math.max(0, Math.min(column, getColumnCount() - 1));
row = Math.max(0, Math.min(row, getRowCount() - 1));
int x = 0;
int y = (height + y_gap) * row;
for (int i = 0; i < column; ++i)
{
x += columnModel.getColumn(i).getWidth();
x += x_gap;
}
if (includeSpacing)
return new Rectangle(x, y, width, height);
else
return new Rectangle(x, y, width - x_gap, height - y_gap);
}
public void clearSelection()
{
selectionModel.clearSelection();
}
/**
* Get the value of the {@link #selectedRow} property by delegation to
* the {@link ListSelectionModel#getMinSelectionIndex} method of the
* {@link #selectionModel} field.
*
* @return The current value of the selectedRow property
*/
public int getSelectedRow ()
{
return selectionModel.getMinSelectionIndex();
}
/**
* Get the value of the {@link #selectionModel} property.
*
* @return The current value of the property
*/
public ListSelectionModel getSelectionModel()
{
if (! rowSelectionAllowed)
return null;
return selectionModel;
}
public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
{
if (orientation == SwingConstants.VERTICAL)
return visibleRect.height * direction;
else
return visibleRect.width * direction;
}
/**
* Get the value of the {@link #scrollableTracksViewportHeight} property.
*
* @return The constant value false
*/
public boolean getScrollableTracksViewportHeight()
{
return false;
}
/**
* Get the value of the {@link #scrollableTracksViewportWidth} property.
*
* @return true unless the {@link autoResizeMode} prperty is
* AUTO_RESIZE_OFF
*/
public boolean getScrollableTracksViewportWidth()
{
if (autoResizeMode == AUTO_RESIZE_OFF)
return false;
else
return true;
}
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
{
// FIXME: I don't exactly know what sun does here. in both cases they
// pick values which do *not* simply expose the next cell in a given
// scroll direction.
if (orientation == SwingConstants.VERTICAL)
return rowHeight;
else
{
int sum = 0;
for (int i = 0; i < getColumnCount(); ++i)
sum += columnModel.getColumn(0).getWidth();
return getColumnCount() == 0 ? 10 : sum / getColumnCount();
}
}
public TableCellEditor getCellEditor(int row, int column)
{
TableCellEditor editor = columnModel.getColumn(column).getCellEditor();
if (editor == null)
editor = getDefaultEditor(dataModel.getColumnClass(column));
return editor;
}
public TableCellEditor getDefaultEditor(Class columnClass)
{
if (defaultEditorsByColumnClass.containsKey(columnClass))
return (TableCellEditor) defaultEditorsByColumnClass.get(columnClass);
else
{
// FIXME: We have at least an editor for Object.class in our defaults.
TableCellEditor r = new DefaultCellEditor(new JTextField());
defaultEditorsByColumnClass.put(columnClass, r);
return r;
}
}
public TableCellRenderer getCellRenderer(int row, int column)
{
TableCellRenderer renderer =
columnModel.getColumn(column).getCellRenderer();
if (renderer == null)
renderer = getDefaultRenderer(dataModel.getColumnClass(column));
return renderer;
}
public void setDefaultRenderer(Class columnClass, TableCellRenderer rend)
{
defaultRenderersByColumnClass.put(columnClass, rend);
}
public TableCellRenderer getDefaultRenderer(Class columnClass)
{
if (defaultRenderersByColumnClass.containsKey(columnClass))
return (TableCellRenderer) defaultRenderersByColumnClass.get(columnClass);
else
{
TableCellRenderer r = new DefaultTableCellRenderer();
defaultRenderersByColumnClass.put(columnClass, r);
return r;
}
}
public int convertColumnIndexToModel(int vc)
{
if (vc < 0)
return vc;
else if (vc > getColumnCount())
return -1;
else
return columnModel.getColumn(vc).getModelIndex();
}
public int convertColumnIndexToView(int mc)
{
if (mc < 0)
return mc;
int ncols = getColumnCount();
for (int vc = 0; vc < ncols; ++vc)
{
if (columnModel.getColumn(vc).getModelIndex() == mc)
return vc;
}
return -1;
}
public Component prepareRenderer(TableCellRenderer renderer,
int row,
int column)
{
boolean rsa = getRowSelectionAllowed();
boolean csa = getColumnSelectionAllowed();
boolean rs = rsa ? getSelectionModel().isSelectedIndex(row) : false;
boolean cs = csa ? columnModel.getSelectionModel().isSelectedIndex(column) : false;
boolean isSelected = ((rsa && csa && rs && cs)
|| (rsa && !csa && rs)
|| (!rsa && csa && cs));
return renderer.getTableCellRendererComponent(this,
dataModel.getValueAt(row,
convertColumnIndexToModel(column)),
isSelected,
false, // hasFocus
row, column);
}
/**
* Get the value of the {@link #autoCreateColumnsFromModel} property.
*
* @return The current value of the property
*/
public boolean getAutoCreateColumnsFromModel()
{
return autoCreateColumnsFromModel;
}
/**
* Get the value of the {@link #autoResizeMode} property.
*
* @return The current value of the property
*/
public int getAutoResizeMode()
{
return autoResizeMode;
}
/**
* Get the value of the {@link #rowHeight} property.
*
* @return The current value of the property
*/
public int getRowHeight()
{
return rowHeight;
}
/**
* Get the value of the {@link #rowMargin} property.
*
* @return The current value of the property
*/
public int getRowMargin()
{
return rowMargin;
}
/**
* Get the value of the {@link #rowSelectionAllowed} property.
*
* @return The current value of the property
*/
public boolean getRowSelectionAllowed()
{
return rowSelectionAllowed;
}
/**
* Get the value of the {@link #cellSelectionEnabled} property.
*
* @return The current value of the property
*/
public boolean getCellSelectionEnabled()
{
return getColumnSelectionAllowed() && getRowSelectionAllowed();
}
/**
* Get the value of the {@link #dataModel} property.
*
* @return The current value of the property
*/
public TableModel getModel()
{
return dataModel;
}
/**
* Get the value of the {@link #columnCount} property by
* delegation to the @{link #columnModel} field.
*
* @return The current value of the columnCount property
*/
public int getColumnCount()
{
return columnModel.getColumnCount();
}
/**
* Get the value of the {@link #rowCount} property by
* delegation to the @{link #dataModel} field.
*
* @return The current value of the rowCount property
*/
public int getRowCount()
{
return dataModel.getRowCount();
}
/**
* Get the value of the {@link #columnModel} property.
*
* @return The current value of the property
*/
public TableColumnModel getColumnModel()
{
return columnModel;
}
/**
* Get the value of the {@link #selectedColumn} property by
* delegation to the @{link #columnModel} field.
*
* @return The current value of the selectedColumn property
*/
public int getSelectedColumn()
{
return columnModel.getSelectionModel().getMinSelectionIndex();
}
private static int countSelections(ListSelectionModel lsm)
{
int lo = lsm.getMinSelectionIndex();
int hi = lsm.getMaxSelectionIndex();
int sum = 0;
if (lo != -1 && hi != -1)
{
switch (lsm.getSelectionMode())
{
case ListSelectionModel.SINGLE_SELECTION:
sum = 1;
break;
case ListSelectionModel.SINGLE_INTERVAL_SELECTION:
sum = hi - lo + 1;
break;
case ListSelectionModel.MULTIPLE_INTERVAL_SELECTION:
for (int i = lo; i <= hi; ++i)
if (lsm.isSelectedIndex(i))
++sum;
break;
}
}
return sum;
}
private static int[] getSelections(ListSelectionModel lsm)
{
int sz = countSelections(lsm);
int [] ret = new int[sz];
int lo = lsm.getMinSelectionIndex();
int hi = lsm.getMaxSelectionIndex();
int j = 0;
java.util.ArrayList ls = new java.util.ArrayList();
if (lo != -1 && hi != -1)
{
switch (lsm.getSelectionMode())
{
case ListSelectionModel.SINGLE_SELECTION:
ret[0] = lo;
break;
case ListSelectionModel.SINGLE_INTERVAL_SELECTION:
for (int i = lo; i <= hi; ++i)
ret[j++] = i;
break;
case ListSelectionModel.MULTIPLE_INTERVAL_SELECTION:
for (int i = lo; i <= hi; ++i)
if (lsm.isSelectedIndex(i))
ret[j++] = i;
break;
}
}
return ret;
}
/**
* Get the value of the {@link #selectedColumnCount} property by
* delegation to the @{link #columnModel} field.
*
* @return The current value of the selectedColumnCount property
*/
public int getSelectedColumnCount()
{
return countSelections(columnModel.getSelectionModel());
}
/**
* Get the value of the {@link #selectedColumns} property by
* delegation to the @{link #columnModel} field.
*
* @return The current value of the selectedColumns property
*/
public int[] getSelectedColumns()
{
return getSelections(columnModel.getSelectionModel());
}
/**
* Get the value of the {@link #columnSelectionAllowed} property.
*
* @return The current value of the columnSelectionAllowed property
*/
public boolean getColumnSelectionAllowed()
{
return getColumnModel().getColumnSelectionAllowed();
}
/**
* Get the value of the {@link #selectedRowCount} property by
* delegation to the @{link #selectionModel} field.
*
* @return The current value of the selectedRowCount property
*/
public int getSelectedRowCount()
{
return countSelections(selectionModel);
}
/**
* Get the value of the {@link #selectedRows} property by
* delegation to the @{link #selectionModel} field.
*
* @return The current value of the selectedRows property
*/
public int[] getSelectedRows()
{
return getSelections(selectionModel);
}
/**
* Get the value of the {@link #accessibleContext} property.
*
* @return The current value of the property
*/
public AccessibleContext getAccessibleContext()
{
return accessibleContext;
}
/**
* Get the value of the {@link #cellEditor} property.
*
* @return The current value of the property
*/
public TableCellEditor getCellEditor()
{
return cellEditor;
}
/**
* Get the value of the {@link #dragEnabled} property.
*
* @return The current value of the property
*/
public boolean getDragEnabled()
{
return dragEnabled;
}
/**
* Get the value of the {@link #gridColor} property.
*
* @return The current value of the property
*/
public Color getGridColor()
{
return gridColor;
}
/**
* Get the value of the {@link #intercellSpacing} property.
*
* @return The current value of the property
*/
public Dimension getIntercellSpacing()
{
return new Dimension(columnModel.getColumnMargin(), rowMargin);
}
/**
* Get the value of the {@link #preferredViewportSize} property.
*
* @return The current value of the property
*/
public Dimension getPreferredScrollableViewportSize()
{
return preferredViewportSize;
}
/**
* Get the value of the {@link #selectionBackground} property.
*
* @return The current value of the property
*/
public Color getSelectionBackground()
{
return selectionBackground;
}
/**
* Get the value of the {@link #selectionForeground} property.
*
* @return The current value of the property
*/
public Color getSelectionForeground()
{
return selectionForeground;
}
/**
* Get the value of the {@link #showHorizontalLines} property.
*
* @return The current value of the property
*/
public boolean getShowHorizontalLines()
{
return showHorizontalLines;
}
/**
* Get the value of the {@link #showVerticalLines} property.
*
* @return The current value of the property
*/
public boolean getShowVerticalLines()
{
return showVerticalLines;
}
/**
* Get the value of the {@link #tableHeader} property.
*
* @return The current value of the property
*/
public JTableHeader getTableHeader()
{
return tableHeader;
}
/**
* Removes specified column from displayable columns of this table.
*
* @param column column to removed
*/
public void removeColumn(TableColumn column)
{
columnModel.removeColumn(column);
}
/**
* Moves column at the specified index to new given location.
*
* @param column index of the column to move
* @param targetColumn index specifying new location of the column
*/
public void moveColumn(int column,int targetColumn)
{
columnModel.moveColumn(column, targetColumn);
}
/**
* Set the value of the {@link #autoCreateColumnsFromModel} property.
*
* @param a The new value of the autoCreateColumnsFromModel property
*/
public void setAutoCreateColumnsFromModel(boolean a)
{
autoCreateColumnsFromModel = a;
}
/**
* Set the value of the {@link #autoResizeMode} property.
*
* @param a The new value of the autoResizeMode property
*/
public void setAutoResizeMode(int a)
{
autoResizeMode = a;
revalidate();
repaint();
}
/**
* Set the value of the {@link #rowHeight} property.
*
* @param r The new value of the rowHeight property
*/
public void setRowHeight(int r)
{
if (rowHeight < 1)
throw new IllegalArgumentException();
rowHeight = r;
revalidate();
repaint();
}
/**
* Set the value of the {@link #rowMargin} property.
*
* @param r The new value of the rowMargin property
*/
public void setRowMargin(int r)
{
rowMargin = r;
revalidate();
repaint();
}
/**
* Set the value of the {@link #rowSelectionAllowed} property.
*
* @param r The new value of the rowSelectionAllowed property
*/
public void setRowSelectionAllowed(boolean r)
{
rowSelectionAllowed = r;
repaint();
}
/**
* Set the value of the {@link #cellSelectionEnabled} property.
*
* @param c The new value of the cellSelectionEnabled property
*/
public void setCellSelectionEnabled(boolean c)
{
setColumnSelectionAllowed(c);
setRowSelectionAllowed(c);
// for backward-compatibility sake:
cellSelectionEnabled = true;
}
/**
* Set the value of the {@link #dataModel} property.
* *Unregister this as a {@link TableModelListener} from
* previous {@link #dataModel} and register it with new parameter
* m.
Set the value of the {@link #columnModel} property.
* *Unregister this as a {@link TableColumnModelListener}
* from previous {@link #columnModel} and register it with new parameter
* c.
Set the value of the {@link #selectionModel} property.
* *Unregister this as a {@link ListSelectionListener}
* from previous {@link #selectionModel} and register it with new
* parameter s.
Set the value of the {@link #cellEditor} property.
* *Unregister this as a {@link CellEditorListener} from
* previous {@link #cellEditor} and register it with new parameter
* c.
Set the value of the {@link #selectionBackground} property.
* *Fire a PropertyChangeEvent with name {@link * #SELECTION_BACKGROUND_CHANGED_PROPERTY} to registered listeners, if * selectionBackground changed.
* * @param s The new value of the selectionBackground property */ public void setSelectionBackground(Color s) { Color tmp = selectionBackground; selectionBackground = s; if (((tmp == null && s != null) || (s == null && tmp != null) || (tmp != null && s != null && !tmp.equals(s)))) firePropertyChange(SELECTION_BACKGROUND_CHANGED_PROPERTY, tmp, s); repaint(); } /** *Set the value of the {@link #selectionForeground} property.
* *Fire a PropertyChangeEvent with name {@link * SELECTION_FOREGROUND_CHANGED_PROPERTY} to registered listeners, if * selectionForeground changed.
* * @param s The new value of the selectionForeground property */ public void setSelectionForeground(Color s) { Color tmp = selectionForeground; selectionForeground = s; if (((tmp == null && s != null) || (s == null && tmp != null) || (tmp != null && s != null && !tmp.equals(s)))) firePropertyChange(SELECTION_FOREGROUND_CHANGED_PROPERTY, tmp, s); repaint(); } /** * Set the value of the {@link #showGrid} property. * * @param s The new value of the showGrid property */ public void setShowGrid(boolean s) { setShowVerticalLines(s); setShowHorizontalLines(s); } /** * Set the value of the {@link #showHorizontalLines} property. * * @param s The new value of the showHorizontalLines property */ public void setShowHorizontalLines(boolean s) { showHorizontalLines = s; repaint(); } /** * Set the value of the {@link #showVerticalLines} property. * * @param s The new value of the showVerticalLines property */ public void setShowVerticalLines(boolean s) { showVerticalLines = s; repaint(); } /** * Set the value of the {@link #tableHeader} property. * * @param t The new value of the tableHeader property */ public void setTableHeader(JTableHeader t) { if (tableHeader != null) tableHeader.setTable(null); tableHeader = t; if (tableHeader != null) tableHeader.setTable(this); revalidate(); repaint(); } protected void configureEnclosingScrollPane() { JScrollPane jsp = (JScrollPane) SwingUtilities.getAncestorOfClass(JScrollPane.class, this); if (jsp != null && tableHeader != null) { jsp.setColumnHeaderView(tableHeader); } } protected void unconfigureEnclosingScrollPane() { JScrollPane jsp = (JScrollPane) SwingUtilities.getAncestorOfClass(JScrollPane.class, this); if (jsp != null) { jsp.setColumnHeaderView(null); } } public void addNotify() { super.addNotify(); configureEnclosingScrollPane(); } public void removeNotify() { super.addNotify(); unconfigureEnclosingScrollPane(); } /** * Sun javadocs describe an unusual implementation of *doLayout which involves some private interfaces. We try
* to implement the same algorithm as is documented, but using the
* columnModel directly. We still use a private helper method, but it has
* a simpler signature.
*/
private void distributeSpill(TableColumn[] cols, int spill)
{
int MIN = 0;
int MAX = 0;
int PREF = 0;
int[] min = new int[cols.length];
int[] max = new int[cols.length];
int[] pref = new int[cols.length];
for (int i = 0; i < cols.length; ++i)
{
pref[i] = cols[i].getPreferredWidth();
min[i] = cols[i].getMinWidth();
max[i] = cols[i].getMaxWidth();
PREF += pref[i];
MIN += min[i];
MAX += max[i];
}
for (int i = 0; i < cols.length; ++i)
{
int adj = 0;
if (spill > 0)
adj = (spill * (pref[i] - min[i])) / (PREF - MIN);
else
adj = (spill * (max[i] - pref[i])) / (MAX - PREF);
cols[i].setWidth(pref[i] + adj);
}
}
public void doLayout()
{
TableColumn resizingColumn = null;
int ncols = getColumnCount();
if (ncols < 1)
return;
int[] pref = new int[ncols];
int prefSum = 0;
int rCol = -1;
if (tableHeader != null)
resizingColumn = tableHeader.getResizingColumn();
for (int i = 0; i < ncols; ++i)
{
TableColumn col = columnModel.getColumn(i);
int p = col.getWidth();
pref[i] = p;
prefSum += p;
if (resizingColumn == col)
rCol = i;
}
int spill = prefSum - getWidth();
if (resizingColumn != null)
{
TableColumn col;
TableColumn [] cols;
switch (getAutoResizeMode())
{
case AUTO_RESIZE_LAST_COLUMN:
col = columnModel.getColumn(ncols-1);
col.setWidth(col.getPreferredWidth() + spill);
break;
case AUTO_RESIZE_NEXT_COLUMN:
col = columnModel.getColumn(ncols-1);
col.setWidth(col.getPreferredWidth() + spill);
break;
case AUTO_RESIZE_ALL_COLUMNS:
cols = new TableColumn[ncols];
for (int i = 0; i < ncols; ++i)
cols[i] = columnModel.getColumn(i);
distributeSpill(cols, spill);
break;
case AUTO_RESIZE_SUBSEQUENT_COLUMNS:
cols = new TableColumn[ncols];
for (int i = rCol; i < ncols; ++i)
cols[i] = columnModel.getColumn(i);
distributeSpill(cols, spill);
break;
case AUTO_RESIZE_OFF:
default:
}
}
else
{
TableColumn [] cols = new TableColumn[ncols];
for (int i = 0; i < ncols; ++i)
cols[i] = columnModel.getColumn(i);
distributeSpill(cols, spill);
}
}
/**
* @deprecated Replaced by doLayout()
*/
public void sizeColumnsToFit(boolean lastColumnOnly)
{
doLayout();
}
/**
* Obsolete since JDK 1.4. Please use doLayout().
*/
public void sizeColumnsToFit(int resizingColumn)
{
doLayout();
}
public String getUIClassID()
{
return "TableUI";
}
/**
* This method returns the table's UI delegate.
*
* @return The table's UI delegate.
*/
public TableUI getUI()
{
return (TableUI) ui;
}
/**
* This method sets the table's UI delegate.
*
* @param ui The table's UI delegate.
*/
public void setUI(TableUI ui)
{
super.setUI(ui);
}
public void updateUI()
{
setUI((TableUI) UIManager.getUI(this));
revalidate();
repaint();
}
public Class getColumnClass(int column)
{
return dataModel.getColumnClass(column);
}
public String getColumnName(int column)
{
return dataModel.getColumnName(column);
}
public int getEditingColumn()
{
return editingColumn;
}
public void setEditingColumn(int column)
{
editingColumn = column;
}
public int getEditingRow()
{
return editingRow;
}
public void setEditingRow(int column)
{
editingRow = column;
}
public Component getEditorComponent()
{
return editorComp;
}
public boolean isEditing()
{
return editorComp != null;
}
public void setDefaultEditor(Class columnClass, TableCellEditor editor)
{
if (editor != null)
defaultEditorsByColumnClass.put(columnClass, editor);
else
defaultEditorsByColumnClass.remove(columnClass);
}
public void addColumnSelectionInterval(int index0, int index1)
{
if ((index0 < 0 || index0 > (getColumnCount()-1)
|| index1 < 0 || index1 > (getColumnCount()-1)))
throw new IllegalArgumentException("Column index out of range.");
getColumnModel().getSelectionModel().addSelectionInterval(index0, index1);
}
public void addRowSelectionInterval(int index0, int index1)
{
if ((index0 < 0 || index0 > (getRowCount()-1)
|| index1 < 0 || index1 > (getRowCount()-1)))
throw new IllegalArgumentException("Row index out of range.");
getSelectionModel().addSelectionInterval(index0, index1);
}
public void setColumnSelectionInterval(int index0, int index1)
{
if ((index0 < 0 || index0 > (getColumnCount()-1)
|| index1 < 0 || index1 > (getColumnCount()-1)))
throw new IllegalArgumentException("Column index out of range.");
getColumnModel().getSelectionModel().setSelectionInterval(index0, index1);
}
public void setRowSelectionInterval(int index0, int index1)
{
if ((index0 < 0 || index0 > (getRowCount()-1)
|| index1 < 0 || index1 > (getRowCount()-1)))
throw new IllegalArgumentException("Row index out of range.");
getSelectionModel().setSelectionInterval(index0, index1);
}
public void removeColumnSelectionInterval(int index0, int index1)
{
if ((index0 < 0 || index0 > (getColumnCount()-1)
|| index1 < 0 || index1 > (getColumnCount()-1)))
throw new IllegalArgumentException("Column index out of range.");
getColumnModel().getSelectionModel().removeSelectionInterval(index0, index1);
}
public void removeRowSelectionInterval(int index0, int index1)
{
if ((index0 < 0 || index0 > (getRowCount()-1)
|| index1 < 0 || index1 > (getRowCount()-1)))
throw new IllegalArgumentException("Row index out of range.");
getSelectionModel().removeSelectionInterval(index0, index1);
}
public boolean isColumnSelected(int column)
{
return getColumnModel().getSelectionModel().isSelectedIndex(column);
}
public boolean isRowSelected(int row)
{
return getSelectionModel().isSelectedIndex(row);
}
public boolean isCellSelected(int row, int column)
{
return isRowSelected(row) && isColumnSelected(column);
}
public void selectAll()
{
setColumnSelectionInterval(0, getColumnCount() - 1);
setRowSelectionInterval(0, getRowCount() - 1);
}
public Object getValueAt(int row, int column)
{
return dataModel.getValueAt(row, convertColumnIndexToModel(column));
}
public void setValueAt(Object value, int row, int column)
{
dataModel.setValueAt(value, row, convertColumnIndexToModel(column));
}
public TableColumn getColumn(Object identifier)
{
return columnModel.getColumn(columnModel.getColumnIndex(identifier));
}
}