org.jdesktop.swingx.JXTable Maven / Gradle / Ivy
Show all versions of swingx Show documentation
/*
* $Id: JXTable.java,v 1.226 2007/11/19 17:52:57 kschaefe Exp $
*
* Copyright 2004 Sun Microsystems, Inc., 4150 Network Circle,
* Santa Clara, California 95054, U.S.A. All rights reserved.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
package org.jdesktop.swingx;
import java.applet.Applet;
import java.awt.Color;
import java.awt.Component;
import java.awt.ComponentOrientation;
import java.awt.Container;
import java.awt.Cursor;
import java.awt.Dimension;
import java.awt.KeyboardFocusManager;
import java.awt.Point;
import java.awt.Rectangle;
import java.awt.Window;
import java.awt.event.ActionEvent;
import java.awt.print.PrinterException;
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
import java.lang.reflect.Field;
import java.text.DateFormat;
import java.text.NumberFormat;
import java.util.Collections;
import java.util.Date;
import java.util.Enumeration;
import java.util.EventObject;
import java.util.HashMap;
import java.util.Hashtable;
import java.util.Iterator;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.TreeSet;
import java.util.Vector;
import java.util.logging.Level;
import java.util.logging.Logger;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import javax.swing.Action;
import javax.swing.ActionMap;
import javax.swing.DefaultCellEditor;
import javax.swing.Icon;
import javax.swing.ImageIcon;
import javax.swing.JCheckBox;
import javax.swing.JComponent;
import javax.swing.JLabel;
import javax.swing.JPopupMenu;
import javax.swing.JScrollPane;
import javax.swing.JTable;
import javax.swing.JTextField;
import javax.swing.JViewport;
import javax.swing.KeyStroke;
import javax.swing.ListSelectionModel;
import javax.swing.ScrollPaneConstants;
import javax.swing.SizeSequence;
import javax.swing.SwingUtilities;
import javax.swing.UIDefaults;
import javax.swing.UIManager;
import javax.swing.border.Border;
import javax.swing.border.EmptyBorder;
import javax.swing.border.LineBorder;
import javax.swing.event.ChangeEvent;
import javax.swing.event.ChangeListener;
import javax.swing.event.ListSelectionEvent;
import javax.swing.event.TableColumnModelEvent;
import javax.swing.event.TableModelEvent;
import javax.swing.table.DefaultTableCellRenderer;
import javax.swing.table.JTableHeader;
import javax.swing.table.TableCellEditor;
import javax.swing.table.TableCellRenderer;
import javax.swing.table.TableColumn;
import javax.swing.table.TableColumnModel;
import javax.swing.table.TableModel;
import org.jdesktop.swingx.action.AbstractActionExt;
import org.jdesktop.swingx.action.BoundAction;
import org.jdesktop.swingx.decorator.AbstractHighlighter;
import org.jdesktop.swingx.decorator.ColorHighlighter;
import org.jdesktop.swingx.decorator.ComponentAdapter;
import org.jdesktop.swingx.decorator.CompoundHighlighter;
import org.jdesktop.swingx.decorator.DefaultSelectionMapper;
import org.jdesktop.swingx.decorator.FilterPipeline;
import org.jdesktop.swingx.decorator.HighlightPredicate;
import org.jdesktop.swingx.decorator.Highlighter;
import org.jdesktop.swingx.decorator.PipelineEvent;
import org.jdesktop.swingx.decorator.PipelineListener;
import org.jdesktop.swingx.decorator.ResetDTCRColorHighlighter;
import org.jdesktop.swingx.decorator.SearchPredicate;
import org.jdesktop.swingx.decorator.SelectionMapper;
import org.jdesktop.swingx.decorator.SizeSequenceMapper;
import org.jdesktop.swingx.decorator.SortController;
import org.jdesktop.swingx.decorator.SortKey;
import org.jdesktop.swingx.decorator.SortOrder;
import org.jdesktop.swingx.event.TableColumnModelExtListener;
import org.jdesktop.swingx.icon.ColumnControlIcon;
import org.jdesktop.swingx.plaf.LookAndFeelAddons;
import org.jdesktop.swingx.plaf.UIManagerExt;
import org.jdesktop.swingx.renderer.ButtonProvider;
import org.jdesktop.swingx.renderer.DefaultTableRenderer;
import org.jdesktop.swingx.renderer.FormatStringValue;
import org.jdesktop.swingx.renderer.IconValue;
import org.jdesktop.swingx.renderer.MappedValue;
import org.jdesktop.swingx.renderer.StringValue;
import org.jdesktop.swingx.table.ColumnControlButton;
import org.jdesktop.swingx.table.ColumnFactory;
import org.jdesktop.swingx.table.DefaultTableColumnModelExt;
import org.jdesktop.swingx.table.TableColumnExt;
import org.jdesktop.swingx.table.TableColumnModelExt;
/**
*
* A JXTable is a JTable with built-in support for row sorting, filtering, and
* highlighting, column visibility and a special popup control on the column
* header for quick access to table configuration. You can instantiate a JXTable
* just as you would a JTable, using a TableModel. However, a JXTable
* automatically wraps TableColumns inside a TableColumnExt instance.
* TableColumnExt supports visibility, sortability, and prototype values for
* column sizing, none of which are available in TableColumn. You can retrieve
* the TableColumnExt instance for a column using {@link #getColumnExt(Object)}
* or {@link #getColumnExt(int colnumber)}.
*
*
* A JXTable is, by default, sortable by clicking on column headers; each
* subsequent click on a header reverses the order of the sort, and a sort arrow
* icon is automatically drawn on the header. Sorting can be disabled using
* {@link #setSortable(boolean)}. Sorting on columns is handled by a Sorter
* instance which contains a Comparator used to compare values in two rows of a
* column. You can replace the Comparator for a given column by using
* getColumnExt("column").setComparator(customComparator)
*
*
* Columns can be hidden or shown by setting the visible property on the
* TableColumnExt using {@link TableColumnExt#setVisible(boolean)}. Columns can
* also be shown or hidden from the column control popup.
*
*
* The column control popup is triggered by an icon drawn to the far right of
* the column headers, above the table's scrollbar (when installed in a
* JScrollPane). The popup allows the user to select which columns should be
* shown or hidden, as well as to pack columns and turn on horizontal scrolling.
* To show or hide the column control, use the
* {@link #setColumnControlVisible(boolean show)}method.
*
*
* Rows can be filtered from a JXTable using a Filter class and a
* FilterPipeline. One assigns a FilterPipeline to the table using
* {@link #setFilters(FilterPipeline)}. Filtering hides, but does not delete or
* permanently remove rows from a JXTable. Filters are used to provide sorting
* to the table--rows are not removed, but the table is made to believe rows in
* the model are in a sorted order.
*
*
* One can automatically highlight certain rows in a JXTable by attaching
* Highlighters with setHighlighters(Highlighter) method. An
* example would be a Highlighter that colors alternate rows in the table for
* readability; AlternateRowHighlighter does this. Again, like Filters,
* Highlighters can be chained together in a CompoundHighlighter to achieve more
* interesting effects.
*
*
* You can resize all columns, selected columns, or a single column using the
* methods like {@link #packAll()}. Packing combines several other aspects of a
* JXTable. If horizontal scrolling is enabled using
* {@link #setHorizontalScrollEnabled(boolean)}, then the scrollpane will allow
* the table to scroll right-left, and columns will be sized to their preferred
* size. To control the preferred sizing of a column, you can provide a
* prototype value for the column in the TableColumnExt using
* {@link TableColumnExt#setPrototypeValue(Object)}. The prototype is used as
* an indicator of the preferred size of the column. This can be useful if some
* data in a given column is very long, but where the resize algorithm would
* normally not pick this up.
*
*
* JXTable guarantees to delegate creation and configuration of TableColumnExt
* to a ColumnFactory. By default, the application-wide shared ColumnFactory is used.
* You can install a custom ColumnFactory, either application-wide by
* {@link ColumnFactory#setInstance(ColumnFactory)} or per table instance by
* {@link #setColumnFactory(ColumnFactory)}.
*
*
* Last, you can also provide searches on a JXTable using the Searchable property.
*
*
* Keys/Actions registered with this component:
*
*
* - "find" - open an appropriate search widget for searching cell content. The
* default action registeres itself with the SearchFactory as search target.
*
- "print" - print the table
*
- {@link JXTable#HORIZONTALSCROLL_ACTION_COMMAND} - toggle the horizontal scrollbar
*
- {@link JXTable#PACKSELECTED_ACTION_COMMAND} - resize the selected column to fit the widest
* cell content
*
- {@link JXTable#PACKALL_ACTION_COMMAND} - resize all columns to fit the widest
* cell content in each column
*
*
*
*
* Key bindings.
*
*
* - "control F" - bound to actionKey "find".
*
*
*
* Client Properties.
*
*
* - {@link JXTable#MATCH_HIGHLIGHTER} - set to Boolean.TRUE to
* use a SearchHighlighter to mark a cell as matching.
*
*
* @author Ramesh Gupta
* @author Amy Fowler
* @author Mark Davidson
* @author Jeanette Winzenburg
*/
public class JXTable extends JTable
implements TableColumnModelExtListener {
/**
*
*/
public static final String FOCUS_PREVIOUS_COMPONENT = "focusPreviousComponent";
/**
*
*/
public static final String FOCUS_NEXT_COMPONENT = "focusNextComponent";
private static final Logger LOG = Logger.getLogger(JXTable.class.getName());
/**
* Identifier of show horizontal scroll action,
* used in JXTable's ActionMap.
*
*/
public static final String HORIZONTALSCROLL_ACTION_COMMAND =
ColumnControlButton.COLUMN_CONTROL_MARKER + "horizontalScroll";
/**
* Identifier of pack table action, used in JXTable's ActionMap.
*/
public static final String PACKALL_ACTION_COMMAND =
ColumnControlButton.COLUMN_CONTROL_MARKER + "packAll";
/**
* Identifier of pack selected column action, used in JXTable's ActionMap.
*/
public static final String PACKSELECTED_ACTION_COMMAND =
ColumnControlButton.COLUMN_CONTROL_MARKER + "packSelected";
/**
* The prefix marker to find table related properties
* in the ResourceBundle.
*/
public static final String UIPREFIX = "JXTable.";
/** key for client property to use SearchHighlighter as match marker. */
public static final String MATCH_HIGHLIGHTER = AbstractSearchable.MATCH_HIGHLIGHTER;
static {
// Hack: make sure the resource bundle is loaded
LookAndFeelAddons.getAddon();
}
/** The FilterPipeline for the table. */
protected FilterPipeline filters;
/** The CompoundHighlighter for the table. */
protected CompoundHighlighter compoundHighlighter;
/**
* The key for the client property deciding about whether
* the color memory hack for DefaultTableCellRenderer should be used.
* @see #resetDefaultTableCellRendererHighlighter()
*/
protected static final String USE_DTCR_COLORMEMORY_HACK = "useDTCRColorMemoryHack";
/**
* The Highlighter used to hack around DefaultTableCellRenderer's color memory.
*/
protected Highlighter resetDefaultTableCellRendererHighlighter;
/** The ComponentAdapter for model data access. */
protected ComponentAdapter dataAdapter;
/** The handler for mapping view/model coordinates of row selection. */
private SelectionMapper selectionMapper;
/** flag to indicate if table is interactively sortable. */
private boolean sortable;
/** Listens for changes from the filters. */
private PipelineListener pipelineListener;
/** Listens for changes from the highlighters. */
private ChangeListener highlighterChangeListener;
/** the factory to use for column creation and configuration. */
private ColumnFactory columnFactory;
/** The default number of visible rows (in a ScrollPane). */
private int visibleRowCount = 20;
/** The default number of visible columns (in a ScrollPane). */
private int visibleColumnCount = -1;
private SizeSequenceMapper rowModelMapper;
private Field rowModelField;
private boolean rowHeightEnabled;
/**
* Flag to indicate if the column control is visible.
*/
private boolean columnControlVisible;
/**
* ScrollPane's original vertical scroll policy. If the column control is
* visible the policy is set to ALWAYS.
*/
private int verticalScrollPolicy;
/**
* The component used a column control in the upper trailing corner of
* an enclosing JScrollPane.
*/
private JComponent columnControlButton;
/**
* Mouse/Motion/Listener keeping track of mouse moved in cell coordinates.
*/
private RolloverProducer rolloverProducer;
/**
* RolloverController: listens to cell over events and repaints
* entered/exited rows.
*/
private TableRolloverController linkController;
/** field to store the autoResizeMode while interactively setting
* horizontal scrollbar to visible.
*/
private int oldAutoResizeMode;
/** property to control the tracksViewportHeight behaviour. */
private boolean fillsViewportHeight;
/** flag to indicate enhanced auto-resize-off behaviour is on.
* This is set/reset in setHorizontalScrollEnabled.
*/
private boolean intelliMode;
/** internal flag indicating that we are in super.doLayout().
* (used in columnMarginChanged to not update the resizingCol's prefWidth).
*/
private boolean inLayout;
/**
* Flag to distinguish internal settings of rowheight from client code
* settings. The rowHeight will be internally adjusted to font size on
* instantiation and in updateUI if the height has not been set explicitly
* by the application.
* @see #adminSetRowHeight(int)
* @see #setRowHeight(int)
*/
protected boolean isXTableRowHeightSet;
/** property to control search behaviour. */
protected Searchable searchable;
/** property to control table's editability as a whole. */
private boolean editable;
private Dimension calculatedPrefScrollableViewportSize;
/** Instantiates a JXTable with a default table model, no data. */
public JXTable() {
init();
}
/**
* Instantiates a JXTable with a specific table model.
*
* @param dm The model to use.
*/
public JXTable(TableModel dm) {
super(dm);
init();
}
/**
* Instantiates a JXTable with a specific table model.
*
* @param dm The model to use.
*/
public JXTable(TableModel dm, TableColumnModel cm) {
super(dm, cm);
init();
}
/**
* Instantiates a JXTable with a specific table model, column model, and
* selection model.
*
* @param dm The table model to use.
* @param cm The colomn model to use.
* @param sm The list selection model to use.
*/
public JXTable(TableModel dm, TableColumnModel cm, ListSelectionModel sm) {
super(dm, cm, sm);
init();
}
/**
* Instantiates a JXTable for a given number of columns and rows.
*
* @param numRows Count of rows to accomodate.
* @param numColumns Count of columns to accomodate.
*/
public JXTable(int numRows, int numColumns) {
super(numRows, numColumns);
init();
}
/**
* Instantiates a JXTable with data in a vector or rows and column names.
*
* @param rowData Row data, as a Vector of Objects.
* @param columnNames Column names, as a Vector of Strings.
*/
public JXTable(Vector rowData, Vector columnNames) {
super(rowData, columnNames);
init();
}
/**
* Instantiates a JXTable with data in a array or rows and column names.
*
* @param rowData Row data, as a two-dimensional Array of Objects (by row,
* for column).
* @param columnNames Column names, as a Array of Strings.
*/
public JXTable(Object[][] rowData, Object[] columnNames) {
super(rowData, columnNames);
init();
}
/**
* Initializes the table for use.
*
*/
private void init() {
putClientProperty(USE_DTCR_COLORMEMORY_HACK, Boolean.TRUE);
setEditable(true);
setSortable(true);
setRolloverEnabled(true);
setTerminateEditOnFocusLost(true);
// guarantee getFilters() to return != null
setFilters(null);
initActionsAndBindings();
initFocusBindings();
// instantiate row height depending ui setting or font size.
updateRowHeightUI(false);
// set to null - don't want hard-coded pixel sizes.
setPreferredScrollableViewportSize(null);
// PENDING: need to duplicate here..
// why doesn't the call in tableChanged work?
initializeColumnWidths();
setFillsViewportHeight(true);
updateLocaleState(getLocale());
}
/**
* Property to enable/disable rollover support. This can be enabled to show
* "live" rollover behaviour, f.i. the cursor over LinkModel cells. Default
* is enabled. If rollover effects are not used, this property should be
* disabled.
*
* @param rolloverEnabled
*/
public void setRolloverEnabled(boolean rolloverEnabled) {
boolean old = isRolloverEnabled();
if (rolloverEnabled == old)
return;
if (rolloverEnabled) {
rolloverProducer = createRolloverProducer();
addMouseListener(rolloverProducer);
addMouseMotionListener(rolloverProducer);
getLinkController().install(this);
} else {
removeMouseListener(rolloverProducer);
removeMouseMotionListener(rolloverProducer);
rolloverProducer = null;
getLinkController().release();
}
firePropertyChange("rolloverEnabled", old, isRolloverEnabled());
}
protected TableRolloverController getLinkController() {
if (linkController == null) {
linkController = createLinkController();
}
return linkController;
}
protected TableRolloverController createLinkController() {
return new TableRolloverController();
}
/**
* creates and returns the RolloverProducer to use.
*
* @return RolloverProducer
*/
protected RolloverProducer createRolloverProducer() {
return new RolloverProducer() {
@Override
protected void updateRolloverPoint(JComponent component,
Point mousePoint) {
JTable table = (JTable) component;
int col = table.columnAtPoint(mousePoint);
int row = table.rowAtPoint(mousePoint);
if ((col < 0) || (row < 0)) {
row = -1;
col = -1;
}
rollover.x = col;
rollover.y = row;
}
};
}
/**
* Returns the rolloverEnabled property.
*
* @return true if rollover is enabled
*/
public boolean isRolloverEnabled() {
return rolloverProducer != null;
}
/**
* listens to rollover properties.
* Repaints effected component regions.
* Updates link cursor.
*
* @author Jeanette Winzenburg
*/
public static class TableRolloverController extends RolloverController {
private Cursor oldCursor;
// --------------------------- JTable rollover
@Override
protected void rollover(Point oldLocation, Point newLocation) {
if (oldLocation != null) {
Rectangle r = component.getCellRect(oldLocation.y, oldLocation.x, false);
r.x = 0;
r.width = component.getWidth();
component.repaint(r);
}
if (newLocation != null) {
Rectangle r = component.getCellRect(newLocation.y, newLocation.x, false);
r.x = 0;
r.width = component.getWidth();
component.repaint(r);
}
setRolloverCursor(newLocation);
}
/**
* overridden to return false if cell editable.
*/
@Override
protected boolean isClickable(Point location) {
return super.isClickable(location) && !component.isCellEditable(location.y, location.x);
}
@Override
protected RolloverRenderer getRolloverRenderer(Point location, boolean prepare) {
TableCellRenderer renderer = component.getCellRenderer(location.y, location.x);
RolloverRenderer rollover = renderer instanceof RolloverRenderer ?
(RolloverRenderer) renderer : null;
if ((rollover != null) && !rollover.isEnabled()) {
rollover = null;
}
if ((rollover != null) && prepare) {
component.prepareRenderer(renderer, location.y, location.x);
}
return rollover;
}
private void setRolloverCursor(Point location) {
if (hasRollover(location)) {
if (oldCursor == null) {
oldCursor = component.getCursor();
component.setCursor(Cursor
.getPredefinedCursor(Cursor.HAND_CURSOR));
}
} else {
if (oldCursor != null) {
component.setCursor(oldCursor);
oldCursor = null;
}
}
}
@Override
protected Point getFocusedCell() {
int leadRow = component.getSelectionModel()
.getLeadSelectionIndex();
int leadColumn = component.getColumnModel().getSelectionModel()
.getLeadSelectionIndex();
return new Point(leadColumn, leadRow);
}
}
//--------------------------------- ColumnControl && Viewport
/**
* Returns the column control visible property.
*
*
* @return boolean to indicate whether the column control is visible.
* @see #setColumnControlVisible(boolean)
* @see #setColumnControl(JComponent)
*/
public boolean isColumnControlVisible() {
return columnControlVisible;
}
/**
* Sets the column control visible property. If true and
* JXTable is contained in a JScrollPane, the
* table adds the column control to the trailing corner of the scroll pane.
*
*
* Note: if the table is not inside a JScrollPane the column
* control is not shown even if this returns true. In this case it's the
* responsibility of the client code to actually show it.
*
*
* The default value is false.
*
* @param visible boolean to indicate if the column control should be shown
* @see #isColumnControlVisible()
* @see #setColumnControl(JComponent)
*
*/
public void setColumnControlVisible(boolean visible) {
boolean old = isColumnControlVisible();
this.columnControlVisible = visible;
if (old != isColumnControlVisible()) {
configureColumnControl();
firePropertyChange("columnControlVisible", old, !old);
}
}
/**
* Returns the component used as column control. Lazily creates the
* control to the default if it is null.
*
* @return component for column control, guaranteed to be != null.
* @see #setColumnControl(JComponent)
* @see #createDefaultColumnControl()
*/
public JComponent getColumnControl() {
if (columnControlButton == null) {
columnControlButton = createDefaultColumnControl();
}
return columnControlButton;
}
/**
* Sets the component used as column control. Updates the enclosing
* JScrollPane if appropriate. Passing a null
* parameter restores the column control to the default.
*
* The component is automatically visible only if the
* columnControlVisible property is true and
* the table is contained in a JScrollPane.
*
*
* NOTE: from the table's perspective, the column control is simply a
* JComponent to add to and keep in the trailing corner of
* the scrollpane. (if any). It's up the concrete control to configure
* itself from and keep synchronized to the columns' states.
*
*
* @param columnControl the JComponent to use as
* columnControl.
* @see #getColumnControl()
* @see #createDefaultColumnControl()
* @see #setColumnControlVisible(boolean)
*
*/
public void setColumnControl(JComponent columnControl) {
// PENDING JW: release old column control? who's responsible?
// Could implement CCB.autoRelease()?
JComponent old = columnControlButton;
this.columnControlButton = columnControl;
configureColumnControl();
firePropertyChange("columnControl", old, getColumnControl());
}
/**
* Creates the default column control used by this table.
* This implementation returns a ColumnControlButton configured
* with default ColumnControlIcon.
*
* @return the default component used as column control.
* @see #setColumnControl(JComponent)
* @see org.jdesktop.swingx.table.ColumnControlButton
* @see org.jdesktop.swingx.icon.ColumnControlIcon
*/
protected JComponent createDefaultColumnControl() {
return new ColumnControlButton(this, new ColumnControlIcon());
}
/**
* Sets the language-sensitive orientation that is to be used to order
* the elements or text within this component.
*
* Overridden to work around a core bug:
* JScrollPane can't cope with
* corners when changing component orientation at runtime.
* This method explicitly re-configures the column control.
*
* @param o the ComponentOrientation for this table.
* @see java.awt.Component#setComponentOrientation(ComponentOrientation)
*/
@Override
public void setComponentOrientation(ComponentOrientation o) {
super.setComponentOrientation(o);
configureColumnControl();
}
/**
* Configures the enclosing JScrollPane.
*
* Overridden to addionally configure the upper trailing corner
* with the column control.
*
* @see #configureColumnControl()
*
*/
@Override
protected void configureEnclosingScrollPane() {
super.configureEnclosingScrollPane();
configureColumnControl();
}
/**
* Configures the upper trailing corner of an enclosing
* JScrollPane.
*
* Adds/removes the ColumnControl depending on the
* columnControlVisible property.
*
* @see #setColumnControlVisible(boolean)
* @see #setColumnControl(JComponent)
*/
protected void configureColumnControl() {
Container p = getParent();
if (p instanceof JViewport) {
Container gp = p.getParent();
if (gp instanceof JScrollPane) {
JScrollPane scrollPane = (JScrollPane) gp;
// Make certain we are the viewPort's view and not, for
// example, the rowHeaderView of the scrollPane -
// an implementor of fixed columns might do this.
JViewport viewport = scrollPane.getViewport();
if (viewport == null || viewport.getView() != this) {
return;
}
if (isColumnControlVisible()) {
verticalScrollPolicy = scrollPane
.getVerticalScrollBarPolicy();
scrollPane.setCorner(JScrollPane.UPPER_TRAILING_CORNER,
getColumnControl());
scrollPane
.setVerticalScrollBarPolicy(ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS);
} else {
if (verticalScrollPolicy != 0) {
// Fix #155-swingx: reset only if we had force always before
// PENDING: JW - doesn't cope with dynamically changing the policy
// shouldn't be much of a problem because doesn't happen too often??
scrollPane.setVerticalScrollBarPolicy(verticalScrollPolicy);
}
try {
scrollPane.setCorner(JScrollPane.UPPER_TRAILING_CORNER,
null);
} catch (Exception ex) {
// Ignore spurious exception thrown by JScrollPane. This
// is a Swing bug!
}
}
}
}
}
//--------------------- actions
/**
* Take over ctrl-tab.
*
*/
private void initFocusBindings() {
setFocusTraversalKeys(KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
new TreeSet());
setFocusTraversalKeys(KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS,
new TreeSet());
getInputMap(WHEN_ANCESTOR_OF_FOCUSED_COMPONENT).put(
KeyStroke.getKeyStroke("ctrl TAB"), FOCUS_NEXT_COMPONENT);
getInputMap(WHEN_ANCESTOR_OF_FOCUSED_COMPONENT).put(
KeyStroke.getKeyStroke("shift ctrl TAB"), FOCUS_PREVIOUS_COMPONENT);
getActionMap().put(FOCUS_NEXT_COMPONENT, createFocusTransferAction(true));
getActionMap().put(FOCUS_PREVIOUS_COMPONENT, createFocusTransferAction(false));
}
/**
* Creates and returns an action for forward/backward focus
* transfer, depending on the given flag.
*
* @param forward a boolean indicating the direction of the
* required focus transfer
* @return the action bound to focusTraversal.
*/
private Action createFocusTransferAction(final boolean forward) {
BoundAction action = new BoundAction(null, forward ?
FOCUS_NEXT_COMPONENT : FOCUS_PREVIOUS_COMPONENT);
action.registerCallback(this, forward ?
"transferFocus" : "transferFocusBackward");
return action;
}
/**
* A small class which dispatches actions.
* TODO (?): Is there a way that we can
* make this static?
*
* PENDING JW: don't use UIAction ... we are in OO-land!
*/
private class Actions extends UIAction {
Actions(String name) {
super(name);
}
public void actionPerformed(ActionEvent evt) {
if ("print".equals(getName())) {
try {
print();
} catch (PrinterException ex) {
// REMIND(aim): should invoke pluggable application error
// handler
LOG.log(Level.WARNING, "", ex);
}
} else if ("find".equals(getName())) {
find();
}
}
}
/**
* Registers additional, per-instance Actions to the
* this table's ActionMap. Binds the search accelerator (as returned
* by the SearchFactory) to the find action.
*
*
*/
private void initActionsAndBindings() {
// Register the actions that this class can handle.
ActionMap map = getActionMap();
map.put("print", new Actions("print"));
map.put("find", new Actions("find"));
// hack around core bug: cancel editing doesn't fire
// reported against SwingX as of #610-swingx
map.put("cancel", createCancelAction());
map.put(PACKALL_ACTION_COMMAND, createPackAllAction());
map.put(PACKSELECTED_ACTION_COMMAND, createPackSelectedAction());
map.put(HORIZONTALSCROLL_ACTION_COMMAND, createHorizontalScrollAction());
KeyStroke findStroke = SearchFactory.getInstance().getSearchAccelerator();
getInputMap(JComponent.WHEN_ANCESTOR_OF_FOCUSED_COMPONENT).put(findStroke, "find");
}
/**
* Creates and returns an Action which cancels an ongoing edit correctly.
* Note: the correct thing to do is to call the editor's cancelEditing, the wrong
* thing to do is to call table removeEditor (as core JTable does...). So this
* is a quick hack around a core bug, reported against SwingX in #610-swingx.
*
* @return an Action which cancels an edit.
*/
private Action createCancelAction() {
Action action = new AbstractActionExt() {
public void actionPerformed(ActionEvent e) {
if (!isEditing()) return;
getCellEditor().cancelCellEditing();
}
};
return action;
}
/**
* Creates and returns the default Action for toggling
* the horizontal scrollBar.
*/
private Action createHorizontalScrollAction() {
BoundAction action = new BoundAction(null,
HORIZONTALSCROLL_ACTION_COMMAND);
action.setStateAction();
action.registerCallback(this, "setHorizontalScrollEnabled");
action.setSelected(isHorizontalScrollEnabled());
return action;
}
/**
* Returns a potentially localized value from the UIManager. The given key
* is prefixed by this table's UIPREFIX before doing the
* lookup. The lookup respects this table's current locale
* property. Returns the key, if no value is found.
*
* @param key the bare key to look up in the UIManager.
* @return the value mapped to UIPREFIX + key or key if no value is found.
*/
protected String getUIString(String key) {
return getUIString(key, getLocale());
}
/**
* Returns a potentially localized value from the UIManager for the
* given locale. The given key
* is prefixed by this table's UIPREFIX before doing the
* lookup. Returns the key, if no value is found.
*
* @param key the bare key to look up in the UIManager.
* @param locale the locale use for lookup
* @return the value mapped to UIPREFIX + key in the given locale,
* or key if no value is found.
*/
protected String getUIString(String key, Locale locale) {
String text = UIManagerExt.getString(UIPREFIX + key, locale);
return text != null ? text : key;
}
/**
* Creates and returns the default Action
* for packing the selected column.
*/
private Action createPackSelectedAction() {
BoundAction action = new BoundAction(null, PACKSELECTED_ACTION_COMMAND);
action.registerCallback(this, "packSelected");
action.setEnabled(getSelectedColumnCount() > 0);
return action;
}
/**
* Creates and returns the default Action
* for packing all columns.
*/
private Action createPackAllAction() {
BoundAction action = new BoundAction(null, PACKALL_ACTION_COMMAND);
action.registerCallback(this, "packAll");
return action;
}
/**
* {@inheritDoc}
* Overridden to update locale-dependent properties.
*
* @see #updateLocaleState(Locale)
*/
@Override
public void setLocale(Locale locale) {
updateLocaleState(locale);
super.setLocale(locale);
}
/**
* Updates locale-dependent state to the given Locale.
*
* Here: updates registered column actions' locale-dependent state.
*
*
* PENDING: Try better to find all column actions including custom
* additions? Or move to columnControl?
*
* @param locale the Locale to use for value lookup
* @see #setLocale(Locale)
* @see #updateLocaleActionState(String)
*/
protected void updateLocaleState(Locale locale) {
updateLocaleActionState(HORIZONTALSCROLL_ACTION_COMMAND, locale);
updateLocaleActionState(PACKALL_ACTION_COMMAND, locale);
updateLocaleActionState(PACKSELECTED_ACTION_COMMAND, locale);
}
/**
* Updates locale-dependent state of action registered with key in
* ActionMap. Does nothing if no action with key is found.
*
* Here: updates the Action's name property.
*
* @param key the string for lookup in this table's ActionMap
* @see #updateLocaleState()
*/
protected void updateLocaleActionState(String key, Locale locale) {
Action action = getActionMap().get(key);
if (action == null) return;
action.putValue(Action.NAME, getUIString(key, locale));
}
//------------------ bound action callback methods
/**
* Resizes all columns to fit their content.
*
* By default this method is bound to the pack all columns
* Action and registered in the table's ActionMap.
*
*/
public void packAll() {
packTable(-1);
}
/**
* Resizes the lead column to fit its content.
*
* By default this method is bound to the pack selected column
* Action and registered in the table's ActionMap.
*/
public void packSelected() {
int selected = getColumnModel().getSelectionModel().getLeadSelectionIndex();
if (selected >= 0) {
packColumn(selected, -1);
}
}
/**
* {@inheritDoc}
*
* Overridden to update the enabled state of the pack selected column
* Action.
*/
@Override
public void columnSelectionChanged(ListSelectionEvent e) {
super.columnSelectionChanged(e);
if (e.getValueIsAdjusting())
return;
Action packSelected = getActionMap().get(PACKSELECTED_ACTION_COMMAND);
if ((packSelected != null)) {
packSelected.setEnabled(!((ListSelectionModel) e.getSource())
.isSelectionEmpty());
}
}
//----------------------- scrollable control
/**
* Sets the enablement of enhanced horizontal scrolling. If enabled, it
* toggles an auto-resize mode which always fills the JViewport
* horizontally and shows the horizontal scrollbar if necessary.
*
*
* The default value is false.
*
*
* Note: this is not a bound property, though it follows
* bean naming conventions.
*
* PENDING: Probably should be... If so, could be taken by a
* listening Action as in the app-framework.
*
* PENDING JW: the name is mis-leading?
*
* @param enabled a boolean indicating whether enhanced auto-resize mode is
* enabled.
* @see #isHorizontalScrollEnabled()
*/
public void setHorizontalScrollEnabled(boolean enabled) {
/*
* PENDING JW: add a "real" mode? Problematic because there are several
* places in core which check for #AUTO_RESIZE_OFF, can't use different
* value without unwanted side-effects. The current solution with tagging
* the #AUTO_RESIZE_OFF by a boolean flag #intelliMode is brittle - need
* to be very careful to turn off again ... Another problem is to keep the
* horizontalScrollEnabled toggling action in synch with this property.
* Yet another problem is the change notification: currently this is _not_
* a bound property.
*
*/
if (enabled == (isHorizontalScrollEnabled()))
return;
if (enabled) {
// remember the resizeOn mode if any
if (getAutoResizeMode() != AUTO_RESIZE_OFF) {
oldAutoResizeMode = getAutoResizeMode();
}
setAutoResizeMode(AUTO_RESIZE_OFF);
// setAutoResizeModel always disables the intelliMode
// must set after calling and update the action again
intelliMode = true;
updateHorizontalAction();
} else {
setAutoResizeMode(oldAutoResizeMode);
}
}
/**
* Returns the current setting for horizontal scrolling.
*
* @return the enablement of enhanced horizontal scrolling.
* @see #setHorizontalScrollEnabled(boolean)
*/
public boolean isHorizontalScrollEnabled() {
return intelliMode && getAutoResizeMode() == AUTO_RESIZE_OFF;
}
/**
* {@inheritDoc}
*
*
* Overridden for internal bookkeeping related to the enhanced
* auto-resize behaviour.
*
*
* Note: to enable/disable the enhanced auto-resize mode use exclusively
* setHorizontalScrollEnabled, this method can't cope with it.
*
* @see #setHorizontalScrollEnabled(boolean)
*
*/
@Override
public void setAutoResizeMode(int mode) {
if (mode != AUTO_RESIZE_OFF) {
oldAutoResizeMode = mode;
}
intelliMode = false;
super.setAutoResizeMode(mode);
updateHorizontalAction();
}
/**
* Synchs selected state of horizontal scrolling Action to
* enablement of enhanced auto-resize behaviour.
*/
protected void updateHorizontalAction() {
Action showHorizontal = getActionMap().get(
HORIZONTALSCROLL_ACTION_COMMAND);
if (showHorizontal instanceof BoundAction) {
((BoundAction) showHorizontal)
.setSelected(isHorizontalScrollEnabled());
}
}
/**
*{@inheritDoc}
*
* Overridden to support enhanced auto-resize behaviour enabled and
* necessary.
*
* @see #setHorizontalScrollEnabled(boolean)
*/
@Override
public boolean getScrollableTracksViewportWidth() {
boolean shouldTrack = super.getScrollableTracksViewportWidth();
if (isHorizontalScrollEnabled()) {
return hasExcessWidth();
}
return shouldTrack;
}
/**
* Layouts column width. The exact behaviour depends on the
* autoResizeMode property.
* Overridden to support enhanced auto-resize behaviour enabled and
* necessary.
*
* @see #setAutoResizeMode(int)
* @see #setHorizontalScrollEnabled(boolean)
*/
@Override
public void doLayout() {
int resizeMode = getAutoResizeMode();
// fool super...
if (isHorizontalScrollEnabled() && hasRealizedParent() && hasExcessWidth()) {
autoResizeMode = oldAutoResizeMode;
}
inLayout = true;
super.doLayout();
inLayout = false;
autoResizeMode = resizeMode;
}
/**
*
* @return boolean to indicate whether the table has a realized parent.
*/
private boolean hasRealizedParent() {
return (getWidth() > 0) && (getParent() != null)
&& (getParent().getWidth() > 0);
}
/**
* PRE: hasRealizedParent()
*
* @return boolean to indicate whether the table has widths excessing parent's width
*/
private boolean hasExcessWidth() {
return getPreferredSize().width < getParent().getWidth();
}
/**
* {@inheritDoc}
*
* Overridden to support enhanced auto-resize behaviour enabled and
* necessary.
*
* @see #setHorizontalScrollEnabled(boolean)
*/
@Override
public void columnMarginChanged(ChangeEvent e) {
if (isEditing()) {
removeEditor();
}
TableColumn resizingColumn = getResizingColumn();
// Need to do this here, before the parent's
// layout manager calls getPreferredSize().
if (resizingColumn != null && autoResizeMode == AUTO_RESIZE_OFF && !inLayout) {
resizingColumn.setPreferredWidth(resizingColumn.getWidth());
}
resizeAndRepaint();
}
/**
* Returns the column which is interactively resized. The return value is
* null if the header is null or has no resizing column.
*
* @return the resizing column.
*/
private TableColumn getResizingColumn() {
return (tableHeader == null) ? null
: tableHeader.getResizingColumn();
}
/**
* Sets the flag which controls the scrollableTracksViewportHeight property.
* If true the table's height will be always at least as large as the
* containing parent, if false the table's height will be independent of
* parent's height.
*
*
* The default value is true.
*
*
* Note: this a backport from Mustang's JTable.
*
* @param fillsViewportHeight boolean to indicate whether the table should
* always fill parent's height.
* @see #getFillsViewportHeight()
* @see #getScrollableTracksViewportHeight()
*/
public void setFillsViewportHeight(boolean fillsViewportHeight) {
if (fillsViewportHeight == getFillsViewportHeight()) return;
boolean old = getFillsViewportHeight();
this.fillsViewportHeight = fillsViewportHeight;
firePropertyChange("fillsViewportHeight", old, getFillsViewportHeight());
revalidate();
}
/**
* Returns the flag which controls the scrollableTracksViewportHeight
* property.
*
* @return true if the table's height will always be at least as large
* as the containing parent, false if it is independent
* @see #setFillsViewportHeight(boolean)
* @see #getScrollableTracksViewportHeight()
*/
public boolean getFillsViewportHeight() {
return fillsViewportHeight;
}
/**
* {@inheritDoc}
*
* Overridden to control the tracksHeight property depending on
* fillsViewportHeight and relative size to containing parent.
*
* @return true if the control flag is true and the containing parent
* height > prefHeight, else returns false.
* @see #setFillsViewportHeight(boolean)
*
*/
@Override
public boolean getScrollableTracksViewportHeight() {
return getFillsViewportHeight()
&& getParent() instanceof JViewport
&& (((JViewport)getParent()).getHeight() > getPreferredSize().height);
}
//------------------------ override super because of filter-awareness
/**
* Returns the row count in the table; if filters are applied, this is the
* filtered row count.
*/
@Override
public int getRowCount() {
// RG: If there are no filters, call superclass version rather than
// accessing model directly
return filters == null ?
super.getRowCount() : filters.getOutputSize();
}
/**
* Convert row index from view coordinates to model coordinates accounting
* for the presence of sorters and filters.
*
* @param row
* row index in view coordinates
* @return row index in model coordinates
*/
public int convertRowIndexToModel(int row) {
return getFilters() != null ? getFilters().convertRowIndexToModel(row): row;
}
/**
* Convert row index from model coordinates to view coordinates accounting
* for the presence of sorters and filters.
*
* @param row
* row index in model coordinates
* @return row index in view coordinates
*/
public int convertRowIndexToView(int row) {
return getFilters() != null ? getFilters().convertRowIndexToView(row): row;
}
/**
* Overridden to account for row index mapping.
* {@inheritDoc}
*/
@Override
public Object getValueAt(int row, int column) {
return getModel().getValueAt(convertRowIndexToModel(row),
convertColumnIndexToModel(column));
}
/**
* Overridden to account for row index mapping. This implementation
* respects the cell's editability, that is it has no effect if
* !isCellEditable(row, column).
*
* {@inheritDoc}
* @see #isCellEditable(int, int)
*/
@Override
public void setValueAt(Object aValue, int row, int column) {
if (!isCellEditable(row, column)) return;
getModel().setValueAt(aValue, convertRowIndexToModel(row),
convertColumnIndexToModel(column));
}
/**
* Returns true if the cell at row and column
* is editable. Otherwise, invoking setValueAt on the cell
* will have no effect.
*
* Overridden to account for row index mapping and to support a layered
* editability control:
*
* - per-table:
JXTable.isEditable()
* - per-column:
TableColumnExt.isEditable()
* - per-cell: controlled by the model
*
TableModel.isCellEditable()
*
* The view cell is considered editable only if all three layers are enabled.
*
* @param row the row index in view coordinates
* @param column the column index in view coordinates
* @return true if the cell is editable
*
* @see #setValueAt(Object, int, int)
* @see #isEditable()
* @see TableColumnExt#isEditable
* @see TableModel#isCellEditable
*/
@Override
public boolean isCellEditable(int row, int column) {
if (!isEditable()) return false;
boolean editable = getModel().isCellEditable(convertRowIndexToModel(row),
convertColumnIndexToModel(column));
if (editable) {
TableColumnExt tableColumn = getColumnExt(column);
if (tableColumn != null) {
editable = tableColumn.isEditable();
}
}
return editable;
}
/**
* Overridden to update selectionMapper
*/
@Override
public void setSelectionModel(ListSelectionModel newModel) {
super.setSelectionModel(newModel);
getSelectionMapper().setViewSelectionModel(getSelectionModel());
}
/**
* {@inheritDoc}
*/
@Override
public void setModel(TableModel newModel) {
// JW: need to look here? is done in tableChanged as well.
boolean wasEnabled = getSelectionMapper().isEnabled();
getSelectionMapper().setEnabled(false);
try {
super.setModel(newModel);
} finally {
getSelectionMapper().setEnabled(wasEnabled);
}
}
/**
* additionally updates filtered state.
* {@inheritDoc}
*/
@Override
public void tableChanged(TableModelEvent e) {
if (getSelectionModel().getValueIsAdjusting()) {
// this may happen if the uidelegate/editor changed selection
// and adjusting state
// before firing a editingStopped
// need to enforce update of model selection
getSelectionModel().setValueIsAdjusting(false);
}
// JW: make SelectionMapper deaf ... super doesn't know about row
// mapping and sets rowSelection in model coordinates
// causing complete confusion.
boolean wasEnabled = getSelectionMapper().isEnabled();
getSelectionMapper().setEnabled(false);
try {
super.tableChanged(e);
updateSelectionAndRowModel(e);
} finally {
getSelectionMapper().setEnabled(wasEnabled);
}
if (shouldSortOnChange(e)) {
use(filters);
}
if (isStructureChanged(e)) {
initializeColumnWidths();
resetCalculatedScrollableSize(true);
}
}
/**
* Returns a boolean to indicate whether the table should be
* resorted after receiving the given event. This implementation
* returns true always.
*
* NOTE: this is a quick hack to give subclasses a hook to
* experiment with conditional keeping the view unsorted, f.i.
* after edits. It's untested ... and will not receive much
* work because in Mustang the DefaultRowSorter has the functionality.
*
* @param e the event which might trigger a resort.
* @return a boolean indicating whether the event should
* trigger a re-sort, here true always.
*/
protected boolean shouldSortOnChange(TableModelEvent e) {
return true;
}
/**
* reset model selection coordinates in SelectionMapper after
* model events.
*
* @param e
*/
private void updateSelectionAndRowModel(TableModelEvent e) {
if (isStructureChanged(e) || isDataChanged(e)) {
// JW fixing part of #172 - trying to adjust lead/anchor to valid
// indices (at least in model coordinates) after super's default clearSelection
// in dataChanged/structureChanged.
hackLeadAnchor(e);
getSelectionMapper().clearModelSelection();
getRowModelMapper().clearModelSizes();
updateViewSizeSequence();
// JW: c&p from JTable
} else if (e.getType() == TableModelEvent.INSERT) {
int start = e.getFirstRow();
int end = e.getLastRow();
if (start < 0) {
start = 0;
}
if (end < 0) {
end = getModel().getRowCount() - 1;
}
// Adjust the selectionMapper to account for the new rows.
int length = end - start + 1;
getSelectionMapper().insertIndexInterval(start, length, true);
getRowModelMapper().insertIndexInterval(start, length, getRowHeight());
} else if (e.getType() == TableModelEvent.DELETE) {
int start = e.getFirstRow();
int end = e.getLastRow();
if (start < 0) {
start = 0;
}
if (end < 0) {
end = getModel().getRowCount() - 1;
}
int deletedCount = end - start + 1;
// Adjust the selectionMapper to account for the new rows
getSelectionMapper().removeIndexInterval(start, end);
getRowModelMapper().removeIndexInterval(start, deletedCount);
}
// nothing to do on TableEvent.updated
}
/**
* Convenience method to detect dataChanged table event type.
*
* @param e the event to examine.
* @return true if the event is of type dataChanged, false else.
*/
protected boolean isDataChanged(TableModelEvent e) {
if (e == null) return false;
return e.getType() == TableModelEvent.UPDATE &&
e.getFirstRow() == 0 &&
e.getLastRow() == Integer.MAX_VALUE;
}
/**
* Convenience method to detect update table event type.
*
* @param e the event to examine.
* @return true if the event is of type update and not dataChanged, false else.
*/
protected boolean isUpdate(TableModelEvent e) {
if (isStructureChanged(e)) return false;
return e.getType() == TableModelEvent.UPDATE &&
e.getLastRow() < Integer.MAX_VALUE;
}
/**
* Convenience method to detect a structureChanged table event type.
* @param e the event to examine.
* @return true if the event is of type structureChanged or null, false else.
*/
protected boolean isStructureChanged(TableModelEvent e) {
return e == null || e.getFirstRow() == TableModelEvent.HEADER_ROW;
}
/**
* Trying to hack around #172-swingx: lead/anchor of row selection model
* is not adjusted to valid (not even model indices!) in the
* usual clearSelection after dataChanged/structureChanged.
*
* Note: as of jdk1.5U6 the anchor/lead of the view selectionModel is
* unconditionally set to -1 after data/structureChanged.
*
* @param e
*/
private void hackLeadAnchor(TableModelEvent e) {
int lead = getSelectionModel().getLeadSelectionIndex();
int anchor = getSelectionModel().getAnchorSelectionIndex();
int lastRow = getModel().getRowCount() - 1;
if ((lead > lastRow) || (anchor > lastRow)) {
lead = anchor = lastRow;
getSelectionModel().setAnchorSelectionIndex(lead);
getSelectionModel().setLeadSelectionIndex(lead);
}
}
/**
* Called if individual row height mapping need to be updated.
* This implementation guards against unnessary access of
* super's private rowModel field.
*/
protected void updateViewSizeSequence() {
SizeSequence sizeSequence = null;
if (isRowHeightEnabled()) {
sizeSequence = getSuperRowModel();
}
getRowModelMapper().setViewSizeSequence(sizeSequence, getRowHeight());
}
/**
* @return SelectionMapper
*/
public SelectionMapper getSelectionMapper() {
// JW: why is this public? Probably made so accidentally?
// maybe not: was introduced in version 1.148 when applying
// Jesse's patch to #386-swingx (added functionality to
// turn off the mapping
if (selectionMapper == null) {
selectionMapper = new DefaultSelectionMapper(filters, getSelectionModel());
}
return selectionMapper;
}
//----------------------------- filters
/** Returns the FilterPipeline for the table. */
public FilterPipeline getFilters() {
// PENDING: this is guaranteed to be != null because
// init calls setFilters(null) which enforces an empty
// pipeline
return filters;
}
/**
* setModel() and setFilters() may be called in either order.
*
* @param pipeline
*/
private void use(FilterPipeline pipeline) {
if (pipeline != null) {
// check JW: adding listener multiple times (after setModel)?
if (initialUse(pipeline)) {
pipeline.addPipelineListener(getFilterPipelineListener());
pipeline.assign(getComponentAdapter());
} else {
pipeline.flush();
}
}
}
/**
* @return true is not yet used in this JXTable, false otherwise
*/
private boolean initialUse(FilterPipeline pipeline) {
if (pipelineListener == null) return true;
PipelineListener[] l = pipeline.getPipelineListeners();
for (int i = 0; i < l.length; i++) {
if (pipelineListener.equals(l[i]))
return false;
}
return true;
}
/**
* Sets the FilterPipeline for filtering table rows, maybe null
* to remove all previously applied filters.
*
* Note: the current "interactive" sortState is preserved (by
* internally copying the old sortKeys to the new pipeline, if any).
*
* @param pipeline the FilterPipeline to use, null removes
* all filters.
*/
public void setFilters(FilterPipeline pipeline) {
FilterPipeline old = getFilters();
List sortKeys = null;
if (old != null) {
old.removePipelineListener(pipelineListener);
sortKeys = old.getSortController().getSortKeys();
}
if (pipeline == null) {
pipeline = new FilterPipeline();
}
filters = pipeline;
filters.getSortController().setSortKeys(sortKeys);
// JW: first assign to prevent (short?) illegal internal state
// #173-swingx
use(filters);
getRowModelMapper().setFilters(filters);
getSelectionMapper().setFilters(filters);
repaint();
}
/** returns the listener for changes in filters. */
protected PipelineListener getFilterPipelineListener() {
if (pipelineListener == null) {
pipelineListener = createPipelineListener();
}
return pipelineListener;
}
/** creates the listener for changes in filters. */
protected PipelineListener createPipelineListener() {
return new PipelineListener() {
public void contentsChanged(PipelineEvent e) {
updateOnFilterContentChanged();
}
};
}
/**
* method called on change notification from filterpipeline.
*/
protected void updateOnFilterContentChanged() {
revalidate();
repaint();
// this is a quick fix for #445-swingx: sort icon not updated on
// programatic sorts
if (getTableHeader() != null) {
getTableHeader().repaint();
}
}
//-------------------------------- sorting
/**
* Sets "sortable" property indicating whether or not this table
* supports sortable columns. If sortable is
* true then sorting will be enabled on all columns whose
* sortable property is true. If
* sortable is false then sorting will be
* disabled for all columns, regardless of each column's individual
* sorting property. The default is true.
*
* @see TableColumnExt#isSortable()
* @param sortable
* boolean indicating whether or not this table supports sortable
* columns
*/
public void setSortable(boolean sortable) {
if (sortable == isSortable())
return;
this.sortable = sortable;
if (!isSortable()) resetSortOrder();
firePropertyChange("sortable", !sortable, sortable);
}
/**
* Returns the table's sortable property.
*
* @return true if the table is sortable.
*/
public boolean isSortable() {
return sortable;
}
/**
* Resets sorting of all columns.
*
*/
public void resetSortOrder() {
// JW PENDING: think about notification instead of manual repaint.
SortController controller = getSortController();
if (controller != null) {
controller.setSortKeys(null);
}
if (getTableHeader() != null) {
getTableHeader().repaint();
}
}
/**
*
* Toggles the sort order of the column at columnIndex.
*
* The exact behaviour is defined by the SortController's
* toggleSortOrder implementation. Typically a unsorted
* column is sorted in ascending order, a sorted column's
* order is reversed.
*
* Respects the tableColumnExt's sortable and comparator
* properties: routes the column's comparator to the SortController
* and does nothing if !isSortable(column).
*
*
* PRE: 0 <= columnIndex < getColumnCount()
*
* @param columnIndex the columnIndex in view coordinates.
*
*/
public void toggleSortOrder(int columnIndex) {
if (!isSortable(columnIndex))
return;
SortController controller = getSortController();
if (controller != null) {
TableColumnExt columnExt = getColumnExt(columnIndex);
controller.toggleSortOrder(convertColumnIndexToModel(columnIndex),
columnExt != null ? columnExt.getComparator() : null);
}
}
/**
* Decides if the column at columnIndex can be interactively sorted.
*
* Here: true if both this table and the column sortable property is
* enabled, false otherwise.
*
* @param columnIndex column in view coordinates
* @return boolean indicating whether or not the column is sortable
* in this table.
*/
protected boolean isSortable(int columnIndex) {
boolean sortable = isSortable();
TableColumnExt tableColumnExt = getColumnExt(columnIndex);
if (tableColumnExt != null) {
sortable = sortable && tableColumnExt.isSortable();
}
return sortable;
}
/**
* Sorts the table by the given column using SortOrder.
*
*
* Respects the tableColumnExt's sortable and comparator
* properties: routes the column's comparator to the SortController
* and does nothing if !isSortable(column).
*
*
* PRE: 0 <= columnIndex < getColumnCount()
*
*
*
* @param columnIndex the column index in view coordinates.
* @param sortOrder the sort order to use. If null or SortOrder.UNSORTED,
* this method has the same effect as resetSortOrder();
*
*/
public void setSortOrder(int columnIndex, SortOrder sortOrder) {
if ((sortOrder == null) || !sortOrder.isSorted()) {
resetSortOrder();
return;
}
if (!isSortable(columnIndex)) return;
SortController sortController = getSortController();
if (sortController != null) {
TableColumnExt columnExt = getColumnExt(columnIndex);
SortKey sortKey = new SortKey(sortOrder,
convertColumnIndexToModel(columnIndex),
columnExt != null ? columnExt.getComparator() : null);
sortController.setSortKeys(Collections.singletonList(sortKey));
}
}
/**
* Returns the SortOrder of the given column.
*
* @param columnIndex the column index in view coordinates.
* @return the interactive sorter's SortOrder if matches the column
* or SortOrder.UNSORTED
*/
public SortOrder getSortOrder(int columnIndex) {
SortController sortController = getSortController();
if (sortController == null) return SortOrder.UNSORTED;
SortKey sortKey = SortKey.getFirstSortKeyForColumn(sortController.getSortKeys(),
convertColumnIndexToModel(columnIndex));
return sortKey != null ? sortKey.getSortOrder() : SortOrder.UNSORTED;
}
/**
*
* Toggles the sort order of the column with identifier.
*
* The exact behaviour is defined by the SortController's
* toggleSortOrder implementation. Typically a unsorted
* column is sorted in ascending order, a sorted column's
* order is reversed.
*
* Respects the tableColumnExt's sortable and comparator
* properties: routes the column's comparator to the SortController
* and does nothing if !isSortable(column).
*
*
* PENDING: JW - define the behaviour if the identifier is not found.
* This can happen if either there's no column at all with the identifier
* or if there's no column of type TableColumnExt.
* Currently does nothing, that is does not change sort state.
*
* @param identifier the column identifier.
*
*/
public void toggleSortOrder(Object identifier) {
if (!isSortable(identifier))
return;
SortController controller = getSortController();
if (controller != null) {
TableColumnExt columnExt = getColumnExt(identifier);
if (columnExt == null) return;
controller.toggleSortOrder(columnExt.getModelIndex(),
columnExt.getComparator());
}
}
/**
* Sorts the table by the given column using the SortOrder.
*
*
* Respects the tableColumnExt's sortable and comparator
* properties: routes the column's comparator to the SortController
* and does nothing if !isSortable(column).
*
*
* PENDING: JW - define the behaviour if the identifier is not found.
* This can happen if either there's no column at all with the identifier
* or if there's no column of type TableColumnExt.
* Currently does nothing, that is does not change sort state.
*
* @param identifier the column's identifier.
* @param sortOrder the sort order to use. If null or SortOrder.UNSORTED,
* this method has the same effect as resetSortOrder();
*
*/
public void setSortOrder(Object identifier, SortOrder sortOrder) {
if ((sortOrder == null) || !sortOrder.isSorted()) {
resetSortOrder();
return;
}
if (!isSortable(identifier)) return;
SortController sortController = getSortController();
if (sortController != null) {
TableColumnExt columnExt = getColumnExt(identifier);
if (columnExt == null) return;
SortKey sortKey = new SortKey(sortOrder,
columnExt.getModelIndex(),
columnExt.getComparator());
sortController.setSortKeys(Collections.singletonList(sortKey));
}
}
/**
* Returns the SortOrder of the given column.
*
* PENDING: JW - define the behaviour if the identifier is not found.
* This can happen if either there's no column at all with the identifier
* or if there's no column of type TableColumnExt.
* Currently returns SortOrder.UNSORTED.
*
* @param identifier the column's identifier.
* @return the interactive sorter's SortOrder if matches the column
* or SortOrder.UNSORTED
*/
public SortOrder getSortOrder(Object identifier) {
SortController sortController = getSortController();
if (sortController == null) return SortOrder.UNSORTED;
TableColumnExt columnExt = getColumnExt(identifier);
if (columnExt == null) return SortOrder.UNSORTED;
int modelIndex = columnExt.getModelIndex();
SortKey sortKey = SortKey.getFirstSortKeyForColumn(sortController.getSortKeys(),
modelIndex);
return sortKey != null ? sortKey.getSortOrder() : SortOrder.UNSORTED;
}
/**
* Decides if the column with identifier can be interactively sorted.
*
* Here: true if both this table and the column sortable property is
* enabled, false otherwise.
*
* @param identifier the column's identifier
* @return boolean indicating whether or not the column is sortable
* in this table.
*/
protected boolean isSortable(Object identifier) {
boolean sortable = isSortable();
TableColumnExt tableColumnExt = getColumnExt(identifier);
if (tableColumnExt != null) {
sortable = sortable && tableColumnExt.isSortable();
}
return sortable;
}
/**
* returns the currently active SortController. Can be null
* on the very first call after instantiation.
* @return the currently active SortController may be null
*/
protected SortController getSortController() {
// // this check is for the sake of the very first call after instantiation
if (filters == null) return null;
return getFilters().getSortController();
}
/**
*
* @return the currently interactively sorted TableColumn or null
* if there is not sorter active or if the sorted column index
* does not correspond to any column in the TableColumnModel.
*/
public TableColumn getSortedColumn() {
// bloody hack: get primary SortKey and
// check if there's a column with it available
SortController controller = getSortController();
if (controller != null) {
SortKey sortKey = SortKey.getFirstSortingKey(controller.getSortKeys());
if (sortKey != null) {
int sorterColumn = sortKey.getColumn();
List columns = getColumns(true);
for (Iterator iter = columns.iterator(); iter.hasNext();) {
TableColumn column = iter.next();
if (column.getModelIndex() == sorterColumn) {
return column;
}
}
}
}
return null;
}
/**
* overridden to remove the interactive sorter if the
* sorted column is no longer contained in the ColumnModel.
*/
@Override
public void columnRemoved(TableColumnModelEvent e) {
// JW - old problem: need access to removed column
// to get hold of removed modelIndex
// to remove interactive sorter if any
// no way
// int modelIndex = convertColumnIndexToModel(e.getFromIndex());
updateSorterAfterColumnRemoved();
super.columnRemoved(e);
}
/**
* guarantee that the interactive sorter is removed if its column
* is removed.
*
*/
private void updateSorterAfterColumnRemoved() {
TableColumn sortedColumn = getSortedColumn();
if (sortedColumn == null) {
resetSortOrder();
}
}
// ----------------- enhanced column support: delegation to TableColumnModel
/**
* Returns the TableColumn at view position
* columnIndex. The return value is not null.
*
*
* NOTE: This delegate method is added to protect developer's from
* unexpected exceptions in jdk1.5+. Super does not expose the
* TableColumn access by index which may lead to unexpected
* IllegalArgumentException: If client code assumes the
* delegate method is available, autoboxing will convert the given int to an
* Integer which will call the getColumn(Object) method.
*
*
* @param viewColumnIndex index of the column with the object in question
*
* @return the TableColumn object that matches the column
* index
* @throws ArrayIndexOutOfBoundsException if viewColumnIndex out of allowed
* range.
*
* @see #getColumn(Object)
* @see #getColumnExt(int)
* @see TableColumnModel#getColumn(int)
*/
public TableColumn getColumn(int viewColumnIndex) {
return getColumnModel().getColumn(viewColumnIndex);
}
/**
* Returns a List of visible TableColumns.
*
* @return a List of visible columns.
* @see #getColumns(boolean)
*/
public List getColumns() {
return Collections.list(getColumnModel().getColumns());
}
/**
* Returns the margin between columns.
*
*
* Convenience to expose column model properties through
* JXTable api.
*
* @return the margin between columns
*
* @see #setColumnMargin(int)
* @see TableColumnModel#getColumnMargin()
*/
public int getColumnMargin() {
return getColumnModel().getColumnMargin();
}
/**
* Sets the margin between columns.
*
* Convenience to expose column model properties through
* JXTable api.
*
* @param value margin between columns; must be greater than or equal to
* zero.
* @see #getColumnMargin()
* @see TableColumnModel#setColumnMargin(int)
*/
public void setColumnMargin(int value) {
getColumnModel().setColumnMargin(value);
}
// ----------------- enhanced column support: delegation to TableColumnModelExt
/**
* Returns the number of contained columns. The count includes or excludes invisible
* columns, depending on whether the includeHidden is true or
* false, respectively. If false, this method returns the same count as
* getColumnCount(). If the columnModel is not of type
* TableColumnModelExt, the parameter value has no effect.
*
* @param includeHidden a boolean to indicate whether invisible columns
* should be included
* @return the number of contained columns, including or excluding the
* invisible as specified.
* @see #getColumnCount()
* @see TableColumnModelExt#getColumnCount(boolean)
*/
public int getColumnCount(boolean includeHidden) {
if (getColumnModel() instanceof TableColumnModelExt) {
return ((TableColumnModelExt) getColumnModel())
.getColumnCount(includeHidden);
}
return getColumnCount();
}
/**
* Returns a List of contained TableColumns.
* Includes or excludes invisible columns, depending on whether the
* includeHidden is true or false, respectively. If false, an
* Iterator over the List is equivalent to the
* Enumeration returned by getColumns().
* If the columnModel is not of type
* TableColumnModelExt, the parameter value has no effect.
*
*
* NOTE: the order of columns in the List depends on whether or not the
* invisible columns are included, in the former case it's the insertion
* order in the latter it's the current order of the visible columns.
*
* @param includeHidden a boolean to indicate whether invisible columns
* should be included
* @return a List of contained columns.
*
* @see #getColumns()
* @see TableColumnModelExt#getColumns(boolean)
*/
public List getColumns(boolean includeHidden) {
if (getColumnModel() instanceof TableColumnModelExt) {
return ((TableColumnModelExt) getColumnModel())
.getColumns(includeHidden);
}
return getColumns();
}
/**
* Returns the first TableColumnExt with the given
* identifier. The return value is null if there is no contained
* column with identifier or if the column with identifier is not
* of type TableColumnExt. The returned column
* may be visible or hidden.
*
* @param identifier the object used as column identifier
* @return first TableColumnExt with the given identifier or
* null if none is found
*
* @see #getColumnExt(int)
* @see #getColumn(Object)
* @see TableColumnModelExt#getColumnExt(Object)
*/
public TableColumnExt getColumnExt(Object identifier) {
if (getColumnModel() instanceof TableColumnModelExt) {
return ((TableColumnModelExt) getColumnModel())
.getColumnExt(identifier);
} else {
// PENDING: not tested!
try {
TableColumn column = getColumn(identifier);
if (column instanceof TableColumnExt) {
return (TableColumnExt) column;
}
} catch (Exception e) {
// TODO: handle exception
}
}
return null;
}
/**
* Returns the TableColumnExt at view position
* columnIndex. The return value is null, if the column at
* position columnIndex is not of type
* TableColumnExt. The returned column is visible.
*
* @param viewColumnIndex the index of the column desired
* @return the TableColumnExt object that matches the column
* index
* @throws ArrayIndexOutOfBoundsException if columnIndex out of allowed
* range, that is if
* (columnIndex < 0) || (columnIndex >= getColumnCount()).
*
* @see #getColumnExt(Object)
* @see #getColumn(int)
* @see TableColumnModelExt#getColumnExt(int)
*/
public TableColumnExt getColumnExt(int viewColumnIndex) {
TableColumn column = getColumn(viewColumnIndex);
if (column instanceof TableColumnExt) {
return (TableColumnExt) column;
}
return null;
}
// ---------------------- enhanced TableColumn/Model support: convenience
/**
* Reorders the columns in the sequence given array. Logical names that do
* not correspond to any column in the model will be ignored. Columns with
* logical names not contained are added at the end.
*
* PENDING JW - do we want this? It's used by JNTable.
*
* @param identifiers array of logical column names
*
* @see #getColumns(boolean)
*/
public void setColumnSequence(Object[] identifiers) {
/*
* JW: not properly tested (not in all in fact) ...
*/
List columns = getColumns(true);
Map map = new HashMap();
for (Iterator iter = columns.iterator(); iter.hasNext();) {
// PENDING: handle duplicate identifiers ...
TableColumn column = (TableColumn) iter.next();
map.put(column.getIdentifier(), column);
getColumnModel().removeColumn(column);
}
for (int i = 0; i < identifiers.length; i++) {
TableColumn column = (TableColumn) map.get(identifiers[i]);
if (column != null) {
getColumnModel().addColumn(column);
columns.remove(column);
}
}
for (Iterator iter = columns.iterator(); iter.hasNext();) {
TableColumn column = (TableColumn) iter.next();
getColumnModel().addColumn(column);
}
}
//--------------- implement TableColumnModelExtListener
/**
* {@inheritDoc}
*
* Listens to column property changes.
*
*/
public void columnPropertyChange(PropertyChangeEvent event) {
if (event.getPropertyName().equals("editable")) {
updateEditingAfterColumnChanged((TableColumn) event.getSource(),
(Boolean) event.getNewValue());
} else if (event.getPropertyName().equals("sortable")) {
updateSortingAfterColumnChanged((TableColumn) event.getSource(),
(Boolean) event.getNewValue());
}
}
/**
* Adjusts editing state after column's property change. Cancels ongoing
* editing if the sending column is the editingColumn and the
* column's editable changed to false, otherwise does nothing.
*
* @param column the TableColumn which sent the change notifcation
* @param editable the new value of the column's editable property
*/
private void updateEditingAfterColumnChanged(TableColumn column, boolean editable) {
if (!isEditing()) return;
int viewIndex = convertColumnIndexToView(column.getModelIndex());
if ((viewIndex < 0) || (viewIndex != getEditingColumn())) return;
getCellEditor().cancelCellEditing();
}
/**
* @param column the TableColumn which sent the change notifcation
* @param sortable the new value of the column's sortable property
*/
private void updateSortingAfterColumnChanged(TableColumn column, boolean sortable) {
TableColumn sortedColumn = getSortedColumn();
if ((sortedColumn == null) || (sortedColumn != column)) return;
// here we assume that there's only one sorted column
// nothing is done to enforce at-least-one sorted column
// todo: search forum for when that was problem
resetSortOrder();
}
// -------------------------- ColumnFactory
/**
* Creates, configures and adds default TableColumns for
* columns in this table's TableModel. Removes all currently
* contained TableColumns. The exact type and configuration
* of the columns is controlled by the ColumnFactory.
*
*
* @see org.jdesktop.swingx.table.ColumnFactory
*
*/
@Override
public void createDefaultColumnsFromModel() {
// JW: when could this happen?
if (getModel() == null)
return;
// Remove any current columns
removeColumns();
createAndAddColumns();
}
/**
* Creates and adds TableColumns for each
* column of the table model.
*
*
*/
private void createAndAddColumns() {
/*
* PENDING: go the whole distance and let the factory decide which model
* columns to map to view columns? That would introduce an collection
* managing operation into the factory, sprawling? Can't (and probably
* don't want to) move all collection related operations over - the
* ColumnFactory relies on TableColumnExt type columns, while
* the JXTable has to cope with all the base types.
*
*/
for (int i = 0; i < getModel().getColumnCount(); i++) {
// add directly to columnModel - don't go through this.addColumn
// to guarantee full control of ColumnFactory
// addColumn has the side-effect to set the header!
TableColumnExt tableColumn = getColumnFactory().createAndConfigureTableColumn(
getModel(), i);
if (tableColumn != null) {
getColumnModel().addColumn(tableColumn);
}
}
}
/**
* Remove all columns, make sure to include hidden.
*
*/
private void removeColumns() {
/*
* TODO: promote this method to superclass, and change
* createDefaultColumnsFromModel() to call this method
*/
List columns = getColumns(true);
for (Iterator iter = columns.iterator(); iter.hasNext();) {
getColumnModel().removeColumn(iter.next());
}
}
/**
* Returns the ColumnFactory.
*
* @return the columnFactory to use for column creation and
* configuration.
*
* @see #setColumnFactory(ColumnFactory)
* @see org.jdesktop.swingx.table.ColumnFactory
*/
public ColumnFactory getColumnFactory() {
/*
* TODO JW: think about implications of not/ copying the reference
* to the shared instance into the table's field? Better
* access the getInstance() on each call? We are on single thread
* anyway...
* Furthermore, we don't expect the instance to change often, typically
* it is configured on startup. So we don't really have to worry about
* changes which would destabilize column state?
*/
if (columnFactory == null) {
return ColumnFactory.getInstance();
// columnFactory = ColumnFactory.getInstance();
}
return columnFactory;
}
/**
* Sets the ColumnFactory to use for column creation and
* configuration. The default value is the shared application
* ColumnFactory.
*
* @param columnFactory the factory to use, null indicates
* to use the shared application factory.
*
* @see #getColumnFactory()
* @see org.jdesktop.swingx.table.ColumnFactory
*/
public void setColumnFactory(ColumnFactory columnFactory) {
/*
*
* TODO auto-configure columns on set? or add public table api to
* do so? Mostly, this is meant to be done once in the lifetime
* of the table, preferably before a model is set ... overshoot?
*
*/
ColumnFactory old = getColumnFactory();
this.columnFactory = columnFactory;
firePropertyChange("columnFactory", old, getColumnFactory());
}
// -------------------------------- enhanced sizing support
/**
* Packs all the columns to their optimal size. Works best with auto
* resizing turned off.
*
* @param margin the margin to apply to each column.
*
* @see #packColumn(int, int)
* @see #packColumn(int, int, int)
*/
public void packTable(int margin) {
for (int c = 0; c < getColumnCount(); c++)
packColumn(c, margin, -1);
}
/**
* Packs an indivudal column in the table.
*
* @param column The Column index to pack in View Coordinates
* @param margin The Margin to apply to the column width.
*
* @see #packColumn(int, int, int)
* @see #packTable(int)
*/
public void packColumn(int column, int margin) {
packColumn(column, margin, -1);
}
/**
* Packs an indivual column in the table to less than or equal to the
* maximum witdth. If maximum is -1 then the column is made as wide as it
* needs.
*
* @param column the column index to pack in view coordinates
* @param margin the margin to apply to the column
* @param max the maximum width the column can be resized to, -1 means no limit
*
* @see #packColumn(int, int)
* @see #packTable(int)
* @see ColumnFactory#packColumn(JXTable, TableColumnExt, int, int)
*/
public void packColumn(int column, int margin, int max) {
getColumnFactory().packColumn(this, getColumnExt(column), margin, max);
}
/**
* Returns the preferred number of rows to show in a
* JScrollPane.
*
* @return the number of rows to show in a JScrollPane
* @see #setVisibleRowCount(int)
*/
public int getVisibleRowCount() {
return visibleRowCount;
}
/**
* Sets the preferred number of rows to show in a JScrollPane.
*
*
* This is a bound property. The default value is 20.
*
* PENDING: allow negative for use-all? Analogous to visColumnCount.
*
* @param visibleRowCount number of rows to show in a JScrollPane
* @throws IllegalArgumentException if given count is negative.
*
* @see #getVisibleRowCount()
*/
public void setVisibleRowCount(int visibleRowCount) {
if (visibleRowCount < 0) throw
new IllegalArgumentException("visible row count must not be negative " + visibleRowCount);
if (getVisibleRowCount() == visibleRowCount) return;
int old = getVisibleRowCount();
this.visibleRowCount = visibleRowCount;
resetCalculatedScrollableSize(false);
firePropertyChange("visibleRowCount", old, getVisibleRowCount());
}
/**
* Returns the preferred number of columns to show in the
* JScrollPane.
*
* @return the number of columns to show in the scroll pane.
*
* @see #setVisibleColumnCount
*/
public int getVisibleColumnCount() {
return visibleColumnCount;
}
/**
* Sets the preferred number of Columns to show in a JScrollPane.
* A negative number is interpreted as use-all available visible columns.
*
*
* This is a bound property. The default value is -1 (effectively the same
* as before the introduction of this property).
*
* @param visibleColumnCount number of rows to show in a JScrollPane
* @see #getVisibleColumnCount()
*/
public void setVisibleColumnCount(int visibleColumnCount) {
if (getVisibleColumnCount() == visibleColumnCount) return;
int old = getVisibleColumnCount();
this.visibleColumnCount = visibleColumnCount;
resetCalculatedScrollableSize(true);
firePropertyChange("visibleColumnCount", old, getVisibleColumnCount());
}
/**
* Resets the calculated scrollable size in one dimension, if appropriate.
*
* @param isColumn flag to denote which dimension to reset, true
* for width, false for height
*
*/
private void resetCalculatedScrollableSize(boolean isColumn) {
if (calculatedPrefScrollableViewportSize != null) {
if (isColumn) {
calculatedPrefScrollableViewportSize.width = -1;
} else {
calculatedPrefScrollableViewportSize.height = -1;
}
}
}
/**
* {@inheritDoc}
*
* If the given dimension is null, the auto-calculation of
* the pref scrollable size is enabled, otherwise the behaviour
* is the same as super.
*
* The default is auto-calc enabled on.
*
* @see #getPreferredScrollableViewportSize()
*/
@Override
public void setPreferredScrollableViewportSize(Dimension size) {
super.setPreferredScrollableViewportSize(size);
}
/**
* {@inheritDoc}
*
* Overridden to support auto-calculation of pref scrollable size, dependent
* on the visible row/column count properties. The auto-calc is on if
* there's no explicit pref scrollable size set. Otherwise the fixed size is
* returned
*
*
* The calculation of the preferred scrollable width is delegated to the
* ColumnFactory to allow configuration with custom strategies implemented
* in custom factories.
*
* @see #setPreferredScrollableViewportSize(Dimension)
* @see org.jdesktop.swingx.table.ColumnFactory#getPreferredScrollableViewportWidth(JXTable)
*/
@Override
public Dimension getPreferredScrollableViewportSize() {
// client code has set this - takes precedence.
Dimension prefSize = super.getPreferredScrollableViewportSize();
if (prefSize != null) {
return new Dimension(prefSize);
}
if (calculatedPrefScrollableViewportSize == null) {
calculatedPrefScrollableViewportSize = new Dimension();
// JW: hmm... fishy ... shouldn't be necessary here?
// maybe its the "early init" in super's tableChanged();
// moved to init which looks okay so far
// initializeColumnPreferredWidths();
}
// the width is reset to -1 in setVisibleColumnCount
if (calculatedPrefScrollableViewportSize.width <= 0) {
calculatedPrefScrollableViewportSize.width = getColumnFactory()
.getPreferredScrollableViewportWidth(this);
}
// the heigth is reset in setVisualRowCount
if (calculatedPrefScrollableViewportSize.height <= 0) {
calculatedPrefScrollableViewportSize.height = getVisibleRowCount()
* getRowHeight();
}
return new Dimension(calculatedPrefScrollableViewportSize);
}
/**
* Initialize the width related properties of all contained
* TableColumns, both visible and hidden.
*
* - PENDING: move into ColumnFactory?
*
- PENDING: what to do if autoCreateColumn off?
*
- PENDING: public? to allow manual setting of column
* properties which might effect their default sizing. Needed
* in testing - but real-world? the factory is meant to
* do the property setting, based on tableModel and meta-data (from where?).
* But leads to funny call sequence for per-table factory (new JXTable(),
* table.setColumnFactory(..), table.setModel(...))
*
* @see #initializeColumnPreferredWidth(TableColumn)
*/
protected void initializeColumnWidths() {
for (TableColumn column : getColumns(true)) {
initializeColumnPreferredWidth(column);
}
}
/**
* Initialize the width related properties of the specified column. The
* details are specified by the current ColumnFactory
* if the column is of type TableColumnExt. Otherwise
* nothing is changed.
*
*
* TODO JW - need to cleanup getScrollablePreferred (refactor and inline)
*
* @param column TableColumn object representing view column
* @see org.jdesktop.swingx.table.ColumnFactory#configureColumnWidths
*/
protected void initializeColumnPreferredWidth(TableColumn column) {
if (column instanceof TableColumnExt) {
getColumnFactory().configureColumnWidths(this,
(TableColumnExt) column);
}
}
// ----------------- scrolling support
/**
* Scrolls vertically to make the given row visible. This might not have any
* effect if the table isn't contained in a JViewport.
*
*
* Note: this method has no precondition as it internally uses
* getCellRect which is lenient to off-range coordinates.
*
* @param row the view row index of the cell
*
* @see #scrollColumnToVisible(int)
* @see #scrollCellToVisible(int, int)
* @see #scrollRectToVisible(Rectangle)
*/
public void scrollRowToVisible(int row) {
Rectangle cellRect = getCellRect(row, 0, false);
Rectangle visibleRect = getVisibleRect();
cellRect.x = visibleRect.x;
cellRect.width = visibleRect.width;
scrollRectToVisible(cellRect);
}
/**
* Scrolls horizontally to make the given column visible. This might not
* have any effect if the table isn't contained in a JViewport.
*
*
* Note: this method has no precondition as it internally uses
* getCellRect which is lenient to off-range coordinates.
*
* @param column the view column index of the cell
*
* @see #scrollRowToVisible(int)
* @see #scrollCellToVisible(int, int)
* @see #scrollRectToVisible(Rectangle)
*/
public void scrollColumnToVisible(int column) {
Rectangle cellRect = getCellRect(0, column, false);
Rectangle visibleRect = getVisibleRect();
cellRect.y = visibleRect.y;
cellRect.height = visibleRect.height;
scrollRectToVisible(cellRect);
}
/**
* Scrolls to make the cell at row and column visible. This might not have
* any effect if the table isn't contained in a JViewport.
*
*
* Note: this method has no precondition as it internally uses
* getCellRect which is lenient to off-range coordinates.
*
* @param row the view row index of the cell
* @param column the view column index of the cell
*
* @see #scrollColumnToVisible(int)
* @see #scrollRowToVisible(int)
* @see #scrollRectToVisible(Rectangle)
*/
public void scrollCellToVisible(int row, int column) {
Rectangle cellRect = getCellRect(row, column, false);
scrollRectToVisible(cellRect);
}
//----------------------- delegating methods?? from super
/**
* Returns the selection mode used by this table's selection model.
*
* PENDING JW - setter?
*
* @return the selection mode used by this table's selection model
* @see ListSelectionModel#getSelectionMode()
*/
public int getSelectionMode() {
return getSelectionModel().getSelectionMode();
}
//----------------------- Search support
/** Opens the find widget for the table. */
private void find() {
SearchFactory.getInstance().showFindInput(this, getSearchable());
}
/**
*
* @return a not-null Searchable for this editor.
*/
public Searchable getSearchable() {
if (searchable == null) {
searchable = new TableSearchable();
}
return searchable;
}
/**
* sets the Searchable for this editor. If null, a default
* searchable will be used.
*
* @param searchable
*/
public void setSearchable(Searchable searchable) {
this.searchable = searchable;
}
public class TableSearchable extends AbstractSearchable {
@Override
protected void findMatchAndUpdateState(Pattern pattern, int startRow,
boolean backwards) {
SearchResult matchRow = null;
if (backwards) {
// CHECK: off-one end still needed?
// Probably not - the findXX don't have side-effects any longer
// hmmm... still needed: even without side-effects we need to
// guarantee calling the notfound update at the very end of the
// loop.
for (int r = startRow; r >= -1 && matchRow == null; r--) {
matchRow = findMatchBackwardsInRow(pattern, r);
updateState(matchRow);
}
} else {
for (int r = startRow; r <= getSize() && matchRow == null; r++) {
matchRow = findMatchForwardInRow(pattern, r);
updateState(matchRow);
}
}
// KEEP - JW: Needed to update if loop wasn't entered!
// the alternative is to go one off in the loop. Hmm - which is
// preferable?
// updateState(matchRow);
}
/**
* called if sameRowIndex && !hasEqualRegEx. Matches the cell at
* row/lastFoundColumn against the pattern. PRE: lastFoundColumn valid.
*
* @param pattern
* @param row
* @return an appropriate SearchResult if matching or null
*/
@Override
protected SearchResult findExtendedMatch(Pattern pattern, int row) {
return findMatchAt(pattern, row, lastSearchResult.foundColumn);
}
/**
* Searches forward through columns of the given row. Starts at
* lastFoundColumn or first column if lastFoundColumn < 0. returns an
* appropriate SearchResult if a matching cell is found in this row or
* null if no match is found. A row index out off range results in a
* no-match.
*
* @param pattern
* @param row
* the row to search
* @return an appropriate SearchResult if a matching cell
* is found in this row or null if no match is found
*/
private SearchResult findMatchForwardInRow(Pattern pattern, int row) {
int startColumn = (lastSearchResult.foundColumn < 0) ? 0 : lastSearchResult.foundColumn;
if (isValidIndex(row)) {
for (int column = startColumn; column < getColumnCount(); column++) {
SearchResult result = findMatchAt(pattern, row, column);
if (result != null)
return result;
}
}
return null;
}
/**
* Searches forward through columns of the given row. Starts at
* lastFoundColumn or first column if lastFoundColumn < 0. returns an
* appropriate SearchResult if a matching cell is found in this row or
* null if no match is found. A row index out off range results in a
* no-match.
*
* @param pattern
* @param row
* the row to search
* @return an appropriate SearchResult if a matching cell is found
* in this row or null if no match is found
*/
private SearchResult findMatchBackwardsInRow(Pattern pattern, int row) {
int startColumn = (lastSearchResult.foundColumn < 0) ? getColumnCount() - 1
: lastSearchResult.foundColumn;
if (isValidIndex(row)) {
for (int column = startColumn; column >= 0; column--) {
SearchResult result = findMatchAt(pattern, row, column);
if (result != null)
return result;
}
}
return null;
}
/**
* Matches the cell content at row/col against the given Pattern.
* Returns an appropriate SearchResult if matching or null if no
* matching
*
* @param pattern
* @param row
* a valid row index in view coordinates
* @param column
* a valid column index in view coordinates
* @return an appropriate SearchResult if matching or null
*/
protected SearchResult findMatchAt(Pattern pattern, int row, int column) {
Object value = getValueAt(row, column);
if (value != null) {
Matcher matcher = pattern.matcher(value.toString());
if (matcher.find()) {
return createSearchResult(matcher, row, column);
}
}
return null;
}
/**
* Called if startIndex is different from last search, reset the column
* to -1 and make sure a backwards/forwards search starts at last/first
* row, respectively.
*
* @param startIndex
* @param backwards
* @return adjusted startIndex
*/
@Override
protected int adjustStartPosition(int startIndex, boolean backwards) {
lastSearchResult.foundColumn = -1;
return super.adjustStartPosition(startIndex, backwards);
}
/**
* Moves the internal start for matching as appropriate and returns the
* new startIndex to use. Called if search was messaged with the same
* startIndex as previously.
*
* @param startRow
* @param backwards
* @return new start index to use
*/
@Override
protected int moveStartPosition(int startRow, boolean backwards) {
if (backwards) {
lastSearchResult.foundColumn--;
if (lastSearchResult.foundColumn < 0) {
startRow--;
}
} else {
lastSearchResult.foundColumn++;
if (lastSearchResult.foundColumn >= getColumnCount()) {
lastSearchResult.foundColumn = -1;
startRow++;
}
}
return startRow;
}
/**
* Checks if the startIndex is a candidate for trying a re-match.
*
*
* @param startIndex
* @return true if the startIndex should be re-matched, false if not.
*/
@Override
protected boolean isEqualStartIndex(final int startIndex) {
return super.isEqualStartIndex(startIndex)
&& isValidColumn(lastSearchResult.foundColumn);
}
/**
* checks if row is in range: 0 <= row < getRowCount().
*
* @param column
* @return true if the column is in range, false otherwise
*/
private boolean isValidColumn(int column) {
return column >= 0 && column < getColumnCount();
}
@Override
protected int getSize() {
return getRowCount();
}
/**
* use and move the match highlighter.
* PRE: markByHighlighter
*
*/
protected void moveMatchByHighlighter() {
AbstractHighlighter searchHL = getConfiguredMatchHighlighter();
// no match
if (!hasMatch(lastSearchResult)) {
return;
} else {
ensureInsertedSearchHighlighters(searchHL);
Rectangle cellRect = getCellRect(lastSearchResult.foundRow, lastSearchResult.foundColumn, true);
if (cellRect != null) {
scrollRectToVisible(cellRect);
}
}
}
/**
* @return
*/
protected AbstractHighlighter getConfiguredMatchHighlighter() {
AbstractHighlighter searchHL = getMatchHighlighter();
HighlightPredicate predicate = HighlightPredicate.NEVER;
// no match
if (hasMatch(lastSearchResult)) {
predicate = new SearchPredicate(lastSearchResult.pattern, lastSearchResult.foundRow, convertColumnIndexToModel(lastSearchResult.foundColumn));
}
searchHL.setHighlightPredicate(predicate);
return searchHL;
}
// /**
// * @param result
// * @return
// */
// protected HighlightPredicate createHighlightPredicate(SearchResult result) {
// HighlightPredicate predicate = HighlightPredicate.NEVER;
// // no match
// if (hasMatch(result)) {
// predicate = new SearchPredicate(result.pattern, result.foundRow, convertColumnIndexToModel(result.foundColumn));
// }
// return predicate;
// }
/**
* @param result
* @return
*/
protected boolean hasMatch(SearchResult result) {
boolean noMatch = (result.getFoundRow() < 0) || (result.getFoundColumn() < 0);
return !noMatch;
}
protected void moveMatchBySelection() {
if (!hasMatch(lastSearchResult)) {
return;
}
int row = lastSearchResult.foundRow;
int column = lastSearchResult.foundColumn;
changeSelection(row, column, false, false);
if (!getAutoscrolls()) {
// scrolling not handled by moving selection
Rectangle cellRect = getCellRect(row, column, true);
if (cellRect != null) {
scrollRectToVisible(cellRect);
}
}
}
@Override
protected void moveMatchMarker() {
if (markByHighlighter()) {
moveMatchByHighlighter();
} else { // use selection
moveMatchBySelection();
}
}
protected boolean markByHighlighter() {
return Boolean.TRUE.equals(getClientProperty(MATCH_HIGHLIGHTER));
}
private void ensureInsertedSearchHighlighters(Highlighter highlighter) {
if (!isInPipeline(highlighter)) {
addHighlighter(highlighter);
}
}
private boolean isInPipeline(Highlighter searchHighlighter) {
Highlighter[] inPipeline = getHighlighters();
if ((inPipeline.length > 0) &&
(searchHighlighter.equals(inPipeline[inPipeline.length -1]))) {
return true;
}
removeHighlighter(searchHighlighter);
return false;
}
private AbstractHighlighter matchHighlighter;
/**
* @return
*/
protected AbstractHighlighter getMatchHighlighter() {
if (matchHighlighter == null) {
matchHighlighter = createMatchHighlighter();
}
return matchHighlighter;
}
/**
* @return
*/
protected AbstractHighlighter createMatchHighlighter() {
return new ColorHighlighter(Color.YELLOW.brighter(), null,
Color.YELLOW.brighter(), null,
HighlightPredicate.NEVER);
}
// private SearchHighlighter searchHighlighter;
// protected SearchHighlighter getSearchHighlighter() {
// if (searchHighlighter == null) {
// searchHighlighter = createSearchHighlighter();
// }
// return searchHighlighter;
// }
//
// protected SearchHighlighter createSearchHighlighter() {
// return new SearchHighlighter();
// }
}
// ----------------------------------- uniform data model access
/**
* @return the unconfigured ComponentAdapter.
*/
protected ComponentAdapter getComponentAdapter() {
if (dataAdapter == null) {
dataAdapter = new TableAdapter(this);
}
return dataAdapter;
}
/**
* Convenience to access a configured ComponentAdapter.
*
* @param row the row index in view coordinates.
* @param column the column index in view coordinates.
* @return the configured ComponentAdapter.
*/
protected ComponentAdapter getComponentAdapter(int row, int column) {
ComponentAdapter adapter = getComponentAdapter();
adapter.row = row;
adapter.column = column;
return adapter;
}
protected static class TableAdapter extends ComponentAdapter {
private final JXTable table;
/**
* Constructs a TableDataAdapter for the specified target
* component.
*
* @param component
* the target component
*/
public TableAdapter(JXTable component) {
super(component);
table = component;
}
/**
* Typesafe accessor for the target component.
*
* @return the target component as a {@link javax.swing.JTable}
*/
public JXTable getTable() {
return table;
}
@Override
public String getColumnName(int columnIndex) {
TableColumn column = getColumnByModelIndex(columnIndex);
return column == null ? "" : column.getHeaderValue().toString();
}
protected TableColumn getColumnByModelIndex(int modelColumn) {
List columns = table.getColumns(true);
for (Iterator iter = columns.iterator(); iter.hasNext();) {
TableColumn column = (TableColumn) iter.next();
if (column.getModelIndex() == modelColumn) {
return column;
}
}
return null;
}
@Override
public String getColumnIdentifier(int columnIndex) {
TableColumn column = getColumnByModelIndex(columnIndex);
Object identifier = column != null ? column.getIdentifier() : null;
return identifier != null ? identifier.toString() : null;
}
@Override
public int getColumnCount() {
return table.getModel().getColumnCount();
}
@Override
public int getRowCount() {
return table.getModel().getRowCount();
}
/**
* {@inheritDoc}
*/
@Override
public Object getValueAt(int row, int column) {
return table.getModel().getValueAt(row, column);
}
@Override
public void setValueAt(Object aValue, int row, int column) {
table.getModel().setValueAt(aValue, row, column);
}
@Override
public boolean isCellEditable(int row, int column) {
return table.getModel().isCellEditable(row, column);
}
@Override
public boolean isTestable(int column) {
return getColumnByModelIndex(column) != null;
}
//-------------------------- accessing view state/values
/**
* {@inheritDoc}
*/
@Override
public Object getFilteredValueAt(int row, int column) {
return getValueAt(table.convertRowIndexToModel(row), column);
// return table.getValueAt(row, modelToView(column)); // in view coordinates
}
/**
* {@inheritDoc}
*/
@Override
public Object getValue() {
return table.getValueAt(row, column);
}
/**
* {@inheritDoc}
*/
@Override
public boolean isEditable() {
return table.isCellEditable(row, column);
}
/**
* {@inheritDoc}
*/
@Override
public boolean isSelected() {
return table.isCellSelected(row, column);
}
/**
* {@inheritDoc}
*/
@Override
public boolean hasFocus() {
boolean rowIsLead = (table.getSelectionModel()
.getLeadSelectionIndex() == row);
boolean colIsLead = (table.getColumnModel().getSelectionModel()
.getLeadSelectionIndex() == column);
return table.isFocusOwner() && (rowIsLead && colIsLead);
}
/**
* {@inheritDoc}
*/
@Override
public int modelToView(int columnIndex) {
return table.convertColumnIndexToView(columnIndex);
}
/**
* {@inheritDoc}
*/
@Override
public int viewToModel(int columnIndex) {
return table.convertColumnIndexToModel(columnIndex);
}
}
// --------------------- managing renderers/editors
/**
* Returns the CompoundHighlighter assigned to the table, null if none.
* PENDING: open up for subclasses again?.
*
* @return the CompoundHighlighter assigned to the table.
* @see #setCompoundHighlighter(CompoundHighlighter)
*/
private CompoundHighlighter getCompoundHighlighter() {
return compoundHighlighter;
}
/**
* Assigns a CompoundHighlighter to the table, maybe null to remove all
* Highlighters.
*
* The default value is null.
*
* PENDING: open up for subclasses again?.
* @param pipeline the CompoundHighlighter to use for renderer decoration.
* @see #getCompoundHighlighter()
* @see #addHighlighter(Highlighter)
* @see #removeHighlighter(Highlighter)
*
*/
private void setCompoundHighlighter(CompoundHighlighter pipeline) {
CompoundHighlighter old = getCompoundHighlighter();
if (old != null) {
old.removeChangeListener(getHighlighterChangeListener());
}
compoundHighlighter = pipeline;
if (compoundHighlighter != null) {
compoundHighlighter.addChangeListener(getHighlighterChangeListener());
}
// PENDING: wrong event - the property is either "compoundHighlighter"
// or "highlighters" with the old/new array as value
firePropertyChange("highlighters", old, getCompoundHighlighter());
repaint();
}
/**
* Sets the Highlighters to the table, replacing any old settings.
* None of the given Highlighters must be null.
*
* Note: the implementation is lenient with a single null highighter
* to ease the api change from previous versions.
*
* PENDING: property change?
*
* @param highlighters zero or more not null highlighters to use for renderer decoration.
*
* @see #getHighlighters()
* @see #addHighlighter(Highlighter)
* @see #removeHighlighter(Highlighter)
*
*/
public void setHighlighters(Highlighter... highlighters) {
CompoundHighlighter pipeline = null;
if ((highlighters != null) && (highlighters.length > 0) &&
(highlighters[0] != null)) {
pipeline = new CompoundHighlighter(highlighters);
}
setCompoundHighlighter(pipeline);
}
/**
* Returns the Highlighters used by this table.
* Maybe empty, but guarantees to be never null.
* @return the Highlighters used by this table, guaranteed to never null.
* @see #setHighlighters(Highlighter[])
*/
public Highlighter[] getHighlighters() {
return getCompoundHighlighter() != null ?
getCompoundHighlighter().getHighlighters() :
CompoundHighlighter.EMPTY_HIGHLIGHTERS;
}
/**
* Adds a Highlighter. Appends to the end of the list of used
* Highlighters.
*
*
* @param highlighter the Highlighter to add.
* @throws NullPointerException if Highlighter is null.
*
* @see #removeHighlighter(Highlighter)
* @see #setHighlighters(Highlighter[])
*/
public void addHighlighter(Highlighter highlighter) {
CompoundHighlighter pipeline = getCompoundHighlighter();
if (pipeline == null) {
setCompoundHighlighter(new CompoundHighlighter(highlighter));
} else {
pipeline.addHighlighter(highlighter);
}
}
/**
* Removes the given Highlighter.
*
* Does nothing if the Highlighter is not contained.
*
* @param highlighter the Highlighter to remove.
* @see #addHighlighter(Highlighter)
* @see #setHighlighters(Highlighter..)
*/
public void removeHighlighter(Highlighter highlighter) {
if ((getCompoundHighlighter() == null)) return;
getCompoundHighlighter().removeHighlighter(highlighter);
}
/**
* Returns the ChangeListener to use with highlighters. Lazily
* creates the listener.
*
* @return the ChangeListener for observing changes of highlighters,
* guaranteed to be not-null
*/
protected ChangeListener getHighlighterChangeListener() {
if (highlighterChangeListener == null) {
highlighterChangeListener = createHighlighterChangeListener();
}
return highlighterChangeListener;
}
/**
* Creates and returns the ChangeListener observing Highlighters.
*
* Here: repaints the table on receiving a stateChanged.
*
* @return the ChangeListener defining the reaction to changes of
* highlighters.
*/
protected ChangeListener createHighlighterChangeListener() {
return new ChangeListener() {
public void stateChanged(ChangeEvent e) {
repaint();
}
};
}
/**
* {@inheritDoc}
*
*
* Overridden to fix core bug #4614616 (NPE if TableModel's
* Class for the column is an interface). This method
* guarantees to always return a not null value. Returns the
* default renderer for Object if super returns
* null.
*
*
*/
@Override
public TableCellRenderer getCellRenderer(int row, int column) {
TableCellRenderer renderer = super.getCellRenderer(row, column);
if (renderer == null) {
renderer = getDefaultRenderer(Object.class);
}
return renderer;
}
/**
* Returns the decorated Component used as a stamp to render
* the specified cell. Overrides superclass version to provide support for
* cell decorators.
*
*
* Adjusts component orientation (guaranteed to happen before applying
* Highlighters)
*
.
*
* Note: DefaultTableCellRenderer and subclasses require a hack to play
* nicely with Highlighters because it has an internal "color memory" in
* setForeground/setBackground. The hack is applied in
* resetDefaultTableCellRendererColors which is called after
* super.prepareRenderer and before applying the Highlighters. The method is
* called always and for all renderers.
*
* @param renderer the TableCellRenderer to prepare
* @param row the row of the cell to render, where 0 is the first row
* @param column the column of the cell to render, where 0 is the first
* column
* @return the decorated Component used as a stamp to render
* the specified cell
* @see #resetDefaultTableCellRendererColors()
* @see org.jdesktop.swingx.decorator.Highlighter
*/
@Override
public Component prepareRenderer(TableCellRenderer renderer, int row,
int column) {
Component stamp = super.prepareRenderer(renderer, row, column);
// #145-swingx: default renderers don't respect componentOrientation.
adjustComponentOrientation(stamp);
// #258-swingx: hacking around DefaultTableCellRenderer color memory.
resetDefaultTableCellRendererColors(stamp, row, column);
if (compoundHighlighter == null) {
return stamp; // no need to decorate renderer with highlighters
} else {
return compoundHighlighter.highlight(stamp, getComponentAdapter(row, column));
}
}
/**
*
* Method to apply a hack around DefaultTableCellRenderer "color memory"
* (Issue #258-swingx). Applies the hack if the client property
* USE_DTCR_COLORMEMORY_HACK having the value of
* Boolean.TRUE, does nothing otherwise. The property is
* true by default.
*
*
* The hack consists of applying a specialized Highlighter to
* force reset the color "memory" of DefaultTableCellRenderer.
* Note that the hack is applied always, that is even if there are no custom
* Highlighters.
*
*
* Client code which solves the problem at the core (that is in a
* well-behaved DefaultTableCellRenderer) can disable the hack by removing
* the client property or by subclassing and override this to do nothing.
*
* @param renderer the TableCellRenderer to hack
* @param row the row of the cell to render
* @param column the column index of the cell to render
*
* @see #prepareRenderer(TableCellRenderer, int, int)
* @see #USE_DTCR_COLORMEMORY_HACK
* @see org.jdesktop.swingx.decorator.ResetDTCRColorHighlighter
*/
protected void resetDefaultTableCellRendererColors(Component renderer,
int row, int column) {
if (!Boolean.TRUE.equals(getClientProperty(USE_DTCR_COLORMEMORY_HACK)))
return;
ComponentAdapter adapter = getComponentAdapter(row, column);
if (resetDefaultTableCellRendererHighlighter == null) {
resetDefaultTableCellRendererHighlighter = new ResetDTCRColorHighlighter();
}
// hacking around DefaultTableCellRenderer color memory.
resetDefaultTableCellRendererHighlighter.highlight(renderer, adapter);
}
/**
* {@inheritDoc}
*
* Overridden to adjust the editor's component orientation.
*/
@Override
public Component prepareEditor(TableCellEditor editor, int row, int column) {
Component comp = super.prepareEditor(editor, row, column);
adjustComponentOrientation(comp);
return comp;
}
/**
* Adjusts the Component's orientation to this
* JXTable's CO if appropriate. The parameter must not be
* null.
*
*
* This implementation synchs the CO always.
*
* @param stamp the Component who's CO may need to be synched,
* must not be null.
*/
protected void adjustComponentOrientation(Component stamp) {
if (stamp.getComponentOrientation().equals(getComponentOrientation()))
return;
stamp.applyComponentOrientation(getComponentOrientation());
}
/**
* Returns a new instance of the default renderer for the specified class.
* This differs from getDefaultRenderer() in that it returns
* a new instance each time so that the renderer may be set and
* customized on a particular column.
*
* NOTE: this doesn't work with swingx renderers! Do we really need it? It
* had been used in JNTable which is practically obsolete. If needed, we
* could make all renderer support classes clonable.
*
* @param columnClass Class of value being rendered
* @return TableCellRenderer instance which renders values of the specified
* type
* @see #getDefaultRenderer(Class)
*/
public TableCellRenderer getNewDefaultRenderer(Class columnClass) {
TableCellRenderer renderer = getDefaultRenderer(columnClass);
if (renderer != null) {
try {
return renderer.getClass().newInstance();
} catch (Exception e) {
LOG.fine("could not create renderer for " + columnClass);
}
}
// JW PENDING: must not return null!
return null;
}
/**
* Creates default cell renderers for Objects, Numbers,
* Dates, Booleans, and Icon/Image/s.
*
* Overridden to install SwingX renderers plus hacking around
* huge memory consumption of UIDefaults (see #6345050 in core Bug parade)
*
* {@inheritDoc}
*
* @see org.jdesktop.swingx.renderer.DefaultTableRenderer
* @see org.jdesktop.swingx.renderer.ComponentProvider
*/
@Override
protected void createDefaultRenderers() {
// super.createDefaultRenderers();
// This duplicates JTable's functionality in order to make the renderers
// available in getNewDefaultRenderer(); If JTable's renderers either
// were public, or it provided a factory for *new* renderers, this would
// not be needed
// hack around #6345050 - new UIDefaults()
// is created with a huge initialCapacity
// giving a dummy key/value array as parameter reduces that capacity
// to length/2.
Object[] dummies = new Object[] { 1, 0, 2, 0, 3, 0, 4, 0, 5, 0, 6, 0,
7, 0, 8, 0, 9, 0, 10, 0, };
defaultRenderersByColumnClass = new UIDefaults(dummies);
defaultRenderersByColumnClass.clear();
// configured default table renderer (internally LabelProvider)
setDefaultRenderer(Object.class, new DefaultTableRenderer());
setDefaultRenderer(Number.class, new DefaultTableRenderer(
FormatStringValue.NUMBER_TO_STRING, JLabel.RIGHT));
setDefaultRenderer(Date.class, new DefaultTableRenderer(
FormatStringValue.DATE_TO_STRING));
// use the same center aligned default for Image/Icon
TableCellRenderer renderer = new DefaultTableRenderer(
new MappedValue(StringValue.EMPTY, IconValue.ICON),
JLabel.CENTER);
setDefaultRenderer(Icon.class, renderer);
setDefaultRenderer(ImageIcon.class, renderer);
// use a ButtonProvider for booleans
setDefaultRenderer(Boolean.class, new DefaultTableRenderer(
new ButtonProvider()));
// // standard renderers
// // Objects
// setLazyRenderer(Object.class,
// "javax.swing.table.DefaultTableCellRenderer");
//
// // Numbers
// setLazyRenderer(Number.class,
// "org.jdesktop.swingx.JXTable$NumberRenderer");
//
// // Doubles and Floats
// setLazyRenderer(Float.class,
// "org.jdesktop.swingx.JXTable$DoubleRenderer");
// setLazyRenderer(Double.class,
// "org.jdesktop.swingx.JXTable$DoubleRenderer");
//
// // Dates
// setLazyRenderer(Date.class, "org.jdesktop.swingx.JXTable$DateRenderer");
//
// // Icons and ImageIcons
// setLazyRenderer(Icon.class, "org.jdesktop.swingx.JXTable$IconRenderer");
// setLazyRenderer(ImageIcon.class,
// "org.jdesktop.swingx.JXTable$IconRenderer");
//
// // Booleans
// setLazyRenderer(Boolean.class,
// "org.jdesktop.swingx.JXTable$BooleanRenderer");
}
/** c&p'ed from super */
@SuppressWarnings("unchecked")
private void setLazyValue(Hashtable h, Class c, String s) {
h.put(c, new UIDefaults.ProxyLazyValue(s));
}
/** c&p'ed from super */
private void setLazyEditor(Class c, String s) {
setLazyValue(defaultEditorsByColumnClass, c, s);
}
/*
* Default Type-based Renderers: JTable's default table cell renderer
* classes are private and JTable:getDefaultRenderer() returns a *shared*
* cell renderer instance, thus there is no way for us to instantiate a new
* instance of one of its default renderers. So, we must replicate the
* default renderer classes here so that we can instantiate them when we
* need to create renderers to be set on specific columns.
*/
/**
* The default renderer for Number types. Aligns to
* RIGHT.
* @deprecated instead use a org.jdesktop.swingx.renderer.DefaultTableRenderer
* configured with a org.jdesktop.swingx.renderer.FormatStringValue
*/
public static class NumberRenderer extends DefaultTableCellRenderer {
public NumberRenderer() {
super();
// JW: RIGHT is the correct thing to do for bidi-compliance
// numbers are right aligned even if text is LToR
setHorizontalAlignment(JLabel.RIGHT);
}
}
/**
* Default renderer for Float and Double
* types. Uses a NumberFormat to renderer. The format can be
* provided by client code, if null the general-purpose number format for
* the current locale is used.
* @deprecated instead use a org.jdesktop.swingx.renderer.DefaultTableRenderer
* configured with a org.jdesktop.swingx.renderer.FormatStringValue
*
*/
public static class DoubleRenderer extends NumberRenderer {
private final NumberFormat formatter;
public DoubleRenderer() {
this(null);
}
public DoubleRenderer(NumberFormat formatter) {
if (formatter == null) {
formatter = NumberFormat.getInstance();
}
this.formatter = formatter;
}
@Override
public void setValue(Object value) {
setText((value == null) ? "" : formatter.format(value));
}
}
/**
* The default renderer for Date types. Uses a
* DateFormat to render. The format can be provided by client
* code, if null the general-purpose date format for the current locale is
* used.
* @deprecated instead use a org.jdesktop.swingx.renderer.DefaultTableRenderer
* configured with a org.jdesktop.swingx.renderer.FormatStringValue
*/
public static class DateRenderer extends DefaultTableCellRenderer {
private final DateFormat formatter;
public DateRenderer() {
this(null);
}
public DateRenderer(DateFormat formatter) {
if (formatter == null) {
formatter = DateFormat.getDateInstance();
}
this.formatter = formatter;
}
@Override
public void setValue(Object value) {
setText((value == null) ? "" : formatter.format(value));
}
}
/**
* The default renderer for Icon and ImageIcon types.
*
* Note: it's registered for both the interface and a concrete class because
* JTable class-based lookup doesn't cope well with interfaces.
*
* @deprecated instead use a org.jdesktop.swingx.renderer.DefaultTableRenderer
* configured with a org.jdesktop.swingx.renderer.IconValue
*
*/
public static class IconRenderer extends DefaultTableCellRenderer {
public IconRenderer() {
super();
setHorizontalAlignment(JLabel.CENTER);
}
@Override
public void setValue(Object value) {
setIcon((value instanceof Icon) ? (Icon) value : null);
}
}
/*
* re- c&p'd from 1.5 JTable.
*/
/**
* The default renderer for Boolean types.
* @deprecated instead use a org.jdesktop.swingx.renderer.DefaultTableRenderer
* configured with a org.jdesktop.swingx.renderer.ButtonProvider
*/
public static class BooleanRenderer extends JCheckBox implements // , UIResource
TableCellRenderer {
private static final Border noFocusBorder = new EmptyBorder(1, 1, 1, 1);
public BooleanRenderer() {
super();
setHorizontalAlignment(JLabel.CENTER);
setBorderPainted(true);
}
public Component getTableCellRendererComponent(JTable table,
Object value, boolean isSelected, boolean hasFocus, int row,
int column) {
if (isSelected) {
setForeground(table.getSelectionForeground());
super.setBackground(table.getSelectionBackground());
} else {
setForeground(table.getForeground());
setBackground(table.getBackground());
}
setSelected((value != null && ((Boolean) value).booleanValue()));
if (hasFocus) {
setBorder(UIManager.getBorder("Table.focusCellHighlightBorder"));
} else {
setBorder(noFocusBorder);
}
return this;
}
}
/**
* Creates default cell editors for objects, numbers, and boolean values.
*
* Overridden to hook enhanced editors (f.i. NumberEditorExt)plus
* hacking around huge memory consumption of UIDefaults (see #6345050 in
* core Bug parade)
*
* @see DefaultCellEditor
*/
@Override
protected void createDefaultEditors() {
Object[] dummies = new Object[] {
1, 0,
2, 0,
3, 0,
4, 0,
5, 0,
6, 0,
7, 0,
8, 0,
9, 0,
10, 0,
};
defaultEditorsByColumnClass = new UIDefaults(dummies);
defaultEditorsByColumnClass.clear();
// defaultEditorsByColumnClass = new UIDefaults();
// Objects
setLazyEditor(Object.class, "org.jdesktop.swingx.JXTable$GenericEditor");
// Numbers
// setLazyEditor(Number.class, "org.jdesktop.swingx.JXTable$NumberEditor");
setLazyEditor(Number.class, "org.jdesktop.swingx.table.NumberEditorExt");
// Booleans
setLazyEditor(Boolean.class, "org.jdesktop.swingx.JXTable$BooleanEditor");
}
/**
* Default editor registered for Object. The editor tries
* to create a new instance of the column's class by reflection. It
* assumes that the class has a constructor taking a single String
* parameter.
*
* The editor can be configured with a custom JTextField.
*
*/
public static class GenericEditor extends DefaultCellEditor {
Class[] argTypes = new Class[]{String.class};
java.lang.reflect.Constructor constructor;
Object value;
public GenericEditor() {
this(new JTextField());
}
public GenericEditor(JTextField textField) {
super(textField);
getComponent().setName("Table.editor");
}
@Override
public boolean stopCellEditing() {
String s = (String)super.getCellEditorValue();
// Here we are dealing with the case where a user
// has deleted the string value in a cell, possibly
// after a failed validation. Return null, so that
// they have the option to replace the value with
// null or use escape to restore the original.
// For Strings, return "" for backward compatibility.
if ("".equals(s)) {
if (constructor.getDeclaringClass() == String.class) {
value = s;
}
super.stopCellEditing();
}
try {
value = constructor.newInstance(new Object[]{s});
}
catch (Exception e) {
((JComponent)getComponent()).setBorder(new LineBorder(Color.red));
return false;
}
return super.stopCellEditing();
}
@Override
public Component getTableCellEditorComponent(JTable table, Object value,
boolean isSelected,
int row, int column) {
this.value = null;
((JComponent)getComponent()).setBorder(new LineBorder(Color.black));
try {
Class type = table.getColumnClass(column);
// Since our obligation is to produce a value which is
// assignable for the required type it is OK to use the
// String constructor for columns which are declared
// to contain Objects. A String is an Object.
if (type == Object.class) {
type = String.class;
}
constructor = type.getConstructor(argTypes);
}
catch (Exception e) {
return null;
}
return super.getTableCellEditorComponent(table, value, isSelected, row, column);
}
@Override
public Object getCellEditorValue() {
return value;
}
}
/**
*
* Editor for Numbers.
* Note: this is no longer registered by default.
* The current default is NumberEditorExt
* which differs from this in being locale-aware.
*
*/
public static class NumberEditor extends GenericEditor {
public NumberEditor() {
((JTextField)getComponent()).setHorizontalAlignment(JTextField.RIGHT);
}
}
/**
* The default editor for Boolean types.
*/
public static class BooleanEditor extends DefaultCellEditor {
public BooleanEditor() {
super(new JCheckBox());
JCheckBox checkBox = (JCheckBox)getComponent();
checkBox.setHorizontalAlignment(JCheckBox.CENTER);
}
}
// ----------------------------- enhanced editing support
/**
* Returns the editable property of the JXTable as a whole.
*
* @return boolean to indicate if the table is editable.
* @see #setEditable
*/
public boolean isEditable() {
return editable;
}
/**
* Sets the editable property. This property allows to mark all cells in a
* table as read-only, independent of their per-column editability as
* returned by TableColumnExt.isEditable and their per-cell
* editability as returned by the TableModel.isCellEditable.
* If a cell is read-only in its column or model layer, this property has no
* effect.
*
*
* The default value is true.
*
* @param editable the flag to indicate if the table is editable.
* @see #isEditable
* @see #isCellEditable(int, int)
*/
public void setEditable(boolean editable) {
boolean old = isEditable();
this.editable = editable;
firePropertyChange("editable", old, isEditable());
}
/**
* Returns the property which determines the edit termination behaviour on
* focus lost.
*
* @return boolean to indicate whether an ongoing edit should be terminated
* if the focus is moved to somewhere outside of the table.
* @see #setTerminateEditOnFocusLost(boolean)
*/
public boolean isTerminateEditOnFocusLost() {
return Boolean.TRUE
.equals(getClientProperty("terminateEditOnFocusLost"));
}
/**
* Sets the property to determine whether an ongoing edit should be
* terminated if the focus is moved to somewhere outside of the table. If
* true, terminates the edit, does nothing otherwise. The exact behaviour is
* implemented in JTable.CellEditorRemover: "outside" is
* interpreted to be on a component which is not under the table hierarchy
* but inside the same toplevel window, "terminate" does so in any case,
* first tries to stop the edit, if that's unsuccessful it cancels the edit.
*
* The default value is true.
*
* @param terminate the flag to determine whether or not to terminate the
* edit
* @see #isTerminateEditOnFocusLost()
*/
public void setTerminateEditOnFocusLost(boolean terminate) {
// JW: we can leave the propertyChange notification to the
// putClientProperty - the key and method name are the same
putClientProperty("terminateEditOnFocusLost", terminate);
}
/**
* Returns the autoStartsEdit property.
*
* @return boolean to indicate whether a keyStroke should try to start
* editing.
* @see #setAutoStartEditOnKeyStroke(boolean)
*/
public boolean isAutoStartEditOnKeyStroke() {
return !Boolean.FALSE
.equals(getClientProperty("JTable.autoStartsEdit"));
}
/**
* Sets the autoStartsEdit property. If true, keystrokes are passed-on to
* the cellEditor of the lead cell to let it decide whether to start an
* edit.
*
* The default value is true.
*
*
* @param autoStart boolean to determine whether a keyStroke should try to
* start editing.
* @see #isAutoStartEditOnKeyStroke()
*/
public void setAutoStartEditOnKeyStroke(boolean autoStart) {
boolean old = isAutoStartEditOnKeyStroke();
// JW: we have to take over propertyChange notification
// because the key and method name are different.
// As a consequence, there are two events fired: one for
// the client prop and one for this method.
putClientProperty("JTable.autoStartsEdit", autoStart);
firePropertyChange("autoStartEditOnKeyStroke", old,
isAutoStartEditOnKeyStroke());
}
/**
* {@inheritDoc}
*
* overridden to install a custom editor remover.
*/
@Override
public boolean editCellAt(int row, int column, EventObject e) {
boolean started = super.editCellAt(row, column, e);
if (started) {
hackEditorRemover();
}
return started;
}
/**
* Overridden with backport from Mustang fix for #4684090, #4887999.
*/
@Override
public void removeEditor() {
// if (editorRemover != null) {
// editorRemover.uninstall();
// editorRemover = null;
// }
boolean isFocusOwnerInTheTable = isFocusOwnerDescending();
// let super do its stuff
super.removeEditor();
if(isFocusOwnerInTheTable) {
requestFocusInWindow();
}
}
/**
* Returns a boolean to indicate if the current focus owner
* is descending from this table.
* Returns false if not editing, otherwise walks the focusOwner
* hierarchy, taking popups into account.
*
* @return a boolean to indicate if the current focus
* owner is contained.
*/
private boolean isFocusOwnerDescending() {
if (!isEditing()) return false;
Component focusOwner =
KeyboardFocusManager.getCurrentKeyboardFocusManager().getFocusOwner();
// PENDING JW: special casing to not fall through ... really wanted?
if (focusOwner == null) return false;
if (isDescending(focusOwner)) return true;
// same with permanent focus owner
Component permanent =
KeyboardFocusManager.getCurrentKeyboardFocusManager().getPermanentFocusOwner();
return isDescending(permanent);
}
/**
* @param focusOwner
* @return
*/
private boolean isDescending(Component focusOwner) {
while (focusOwner != null) {
if (focusOwner instanceof JPopupMenu) {
focusOwner = ((JPopupMenu) focusOwner).getInvoker();
if (focusOwner == null) {
return false;
}
}
if (focusOwner == this) {
return true;
}
focusOwner = focusOwner.getParent();
}
return false;
}
protected transient CellEditorRemover editorRemover;
/**
* removes the standard editor remover and adds the custom
* remover.
*
*/
private void hackEditorRemover() {
KeyboardFocusManager manager = KeyboardFocusManager.getCurrentKeyboardFocusManager();
PropertyChangeListener[] listeners = manager.getPropertyChangeListeners("permanentFocusOwner");
for (int i = listeners.length - 1; i >= 0; i--) {
if (listeners[i].getClass().getName().startsWith("javax.swing.JTable")) {
manager.removePropertyChangeListener("permanentFocusOwner", listeners[i]);
break;
}
}
if (editorRemover == null) {
editorRemover = new CellEditorRemover();
}
}
/**
* {@inheritDoc}
*
* Overridden to uninstall the custom editor remover.
*/
@Override
public void removeNotify() {
if (editorRemover != null) {
editorRemover.uninstall();
editorRemover = null;
}
super.removeNotify();
}
/**
* {@inheritDoc}
*
* Overridden to prevent spurious focus loss to outside
* of table while removing the editor. This is essentially
* a hack around core bug #6210779.
*
* PENDING: add link to wiki!
*/
@Override
public boolean isFocusCycleRoot() {
if (isEditingFocusCycleRoot()) {
return true;
}
return super.isFocusCycleRoot();
}
/**
* {@inheritDoc}
* Overridden to try to stop the edit, if appropriate. Calls super
* if succeeded, does not yield otherwise.
*
*/
@Override
public void transferFocus() {
if (isEditingFocusCycleRoot() &&
!getCellEditor().stopCellEditing()) return;
super.transferFocus();
}
/**
* {@inheritDoc}
* Overridden to try to stop the edit, if appropiate. Calls super
* if succeeded, does not yield otherwise.
*
*/
@Override
public void transferFocusBackward() {
if (isEditingFocusCycleRoot() &&
!getCellEditor().stopCellEditing()) return;
super.transferFocusBackward();
}
/**
*
* @return a boolean to indicate whether the table needs
* to fake being focus cycle root.
*/
private boolean isEditingFocusCycleRoot() {
return isEditing() && isTerminateEditOnFocusLost();
}
/**
* This class tracks changes in the keyboard focus state. It is used when
* the JTable is editing to determine when to cancel the edit. If focus
* switches to a component outside of the jtable, but in the same window,
* this will cancel editing.
*/
class CellEditorRemover implements PropertyChangeListener {
KeyboardFocusManager focusManager;
public CellEditorRemover() {
install();
}
private void install() {
focusManager = KeyboardFocusManager.getCurrentKeyboardFocusManager();
focusManager.addPropertyChangeListener("permanentFocusOwner", this);
focusManager.addPropertyChangeListener("managingFocus", this);
}
/**
* remove all listener registrations.
*
*/
public void uninstall() {
focusManager.removePropertyChangeListener("permanentFocusOwner", this);
focusManager.removePropertyChangeListener("managingFocus", this);
focusManager = null;
}
public void propertyChange(PropertyChangeEvent ev) {
if (ev == null) return;
if ("permanentFocusOwner".equals(ev.getPropertyName())) {
permanentFocusOwnerChange();
} else if ("managingFocus".equals(ev.getPropertyName())) {
// TODO uninstall/install after manager changed.
}
}
/**
*
*/
private void permanentFocusOwnerChange() {
if (!isEditing() || !isTerminateEditOnFocusLost()) {
return;
}
Component c = focusManager.getPermanentFocusOwner();
while (c != null) {
// PENDING JW: logic untested!
if (c instanceof JPopupMenu) {
c = ((JPopupMenu) c).getInvoker();
} else {
if (c == JXTable.this) {
// focus remains inside the table
return;
} else if (c instanceof JPopupMenu) {
// PENDING JW: left-over? we should never reach this ...
// need to switch the hierarchy to a popups invoker
} else if ((c instanceof Window) ||
(c instanceof Applet && c.getParent() == null)) {
if (c == SwingUtilities.getRoot(JXTable.this)) {
if (!getCellEditor().stopCellEditing()) {
getCellEditor().cancelCellEditing();
}
}
break;
}
c = c.getParent();
}
}
}
}
// ---------------------------- updateUI support
/**
* {@inheritDoc}
*
* Additionally updates auto-adjusted row height and highlighters.
*
* Another of the override motivation is to fix core issue (?? ID): super
* fails to update all renderers/editors.
*/
@Override
public void updateUI() {
super.updateUI();
if (columnControlButton != null) {
columnControlButton.updateUI();
}
for (Enumeration defaultEditors = defaultEditorsByColumnClass
.elements(); defaultEditors.hasMoreElements();) {
updateEditorUI(defaultEditors.nextElement());
}
for (Enumeration defaultRenderers = defaultRenderersByColumnClass
.elements(); defaultRenderers.hasMoreElements();) {
updateRendererUI(defaultRenderers.nextElement());
}
List columns = getColumns(true);
for (Iterator iter = columns.iterator(); iter.hasNext();) {
TableColumn column = (TableColumn) iter.next();
updateEditorUI(column.getCellEditor());
updateRendererUI(column.getCellRenderer());
updateRendererUI(column.getHeaderRenderer());
}
updateRowHeightUI(true);
updateHighlighterUI();
}
/**
* Updates highlighter after updateUI changes.
*
* @see org.jdesktop.swingx.decorator.UIDependent
*/
protected void updateHighlighterUI() {
if (getCompoundHighlighter() == null)
return;
getCompoundHighlighter().updateUI();
}
/**
* Auto-adjusts rowHeight to something more pleasing then the default. This
* method is called after instantiation and after updating the UI. Does
* nothing if the given parameter is true and the rowHeight
* had been already set by client code. The underlying problem is that raw
* types can't implement UIResource.
*
* This implementation asks the UIManager for a default value (stored with
* key "JXTable.rowHeight"). If none is available, calculates a "reasonable"
* height from the table's fontMetrics, assuming that most renderers/editors
* will have a border with top/bottom of 1.
*
*
* @param respectRowSetFlag a boolean to indicate whether client-code flag
* should be respected.
* @see #isXTableRowHeightSet
*/
protected void updateRowHeightUI(boolean respectRowSetFlag) {
if (respectRowSetFlag && isXTableRowHeightSet)
return;
int uiHeight = UIManager.getInt(UIPREFIX + "rowHeight");
if (uiHeight > 0) {
setRowHeight(uiHeight);
} else {
int fontBasedHeight = getFontMetrics(getFont()).getHeight() + 2;
int magicMinimum = 18;
setRowHeight(Math.max(fontBasedHeight, magicMinimum));
}
isXTableRowHeightSet = false;
}
/**
* Convenience to set both grid line visibility and default margin for
* horizontal/vertical lines. The margin defaults to 1 or 0 if the grid
* lines are drawn or not drawn.
*
* @param showHorizontalLines boolean to decide whether to draw horizontal
* grid lines.
* @param showVerticalLines boolean to decide whether to draw vertical grid
* lines.
* @deprecated replaced by {@link #setShowGrid(boolean, boolean)}.
*
*/
public void setDefaultMargins(boolean showHorizontalLines,
boolean showVerticalLines) {
setShowGrid(showHorizontalLines, showVerticalLines);
}
/**
* Convenience to set both grid line visibility and default margin for
* horizontal/vertical lines. The margin defaults to 1 or 0 if the grid
* lines are drawn or not drawn.
*
* @param showHorizontalLines boolean to decide whether to draw horizontal
* grid lines.
* @param showVerticalLines boolean to decide whether to draw vertical grid
* lines.
* @see javax.swing.JTable#setShowGrid(boolean)
* @see javax.swing.JTable#setIntercellSpacing(Dimension)
*/
public void setShowGrid(boolean showHorizontalLines, boolean showVerticalLines) {
int defaultRowMargin = showHorizontalLines ? 1 : 0;
setRowMargin(defaultRowMargin);
setShowHorizontalLines(showHorizontalLines);
int defaultColumnMargin = showVerticalLines ? 1 : 0;
setColumnMargin(defaultColumnMargin);
setShowVerticalLines(showVerticalLines);
}
/**
* {@inheritDoc}
* Behaves exactly like super.
* It's overridden to
* warn against a frequent programming error: this method toggles only the
* visibility of the grid lines, it does not update the row/column
* margins - which may lead to visual artefacts, as f.i. not showing the lines at all or
* showing normal table background in selected state where the lines should have been.
*
* @see #setShowGrid(boolean, boolean) for an alternative
*/
@Override
public void setShowGrid(boolean showGrid) {
super.setShowGrid(showGrid);
}
/**
* {@inheritDoc}
*
* Overriden to keep view/model coordinates of SizeSequence in synch. Marks
* the request as client-code induced.
*
* @see #isXTableRowHeightSet
*/
@Override
public void setRowHeight(int rowHeight) {
super.setRowHeight(rowHeight);
if (rowHeight > 0) {
isXTableRowHeightSet = true;
}
updateViewSizeSequence();
}
/**
* {@inheritDoc}
*
* Does nothing if support of individual rowHeights is not enabled.
* Overriden to keep view/model coordinates of SizeSequence in synch.
*
* @see #isRowHeightEnabled()
*/
@Override
public void setRowHeight(int row, int rowHeight) {
if (!isRowHeightEnabled())
return;
super.setRowHeight(row, rowHeight);
updateViewSizeSequence();
resizeAndRepaint();
}
/**
* Sets enablement of individual rowHeight support. Enabling the support
* involves reflective access to super's private field rowModel which may
* fail due to security issues. If failing the support is not enabled.
*
* The default value is false.
*
* @param enabled a boolean to indicate whether per-row heights should be
* enabled.
* @see #isRowHeightEnabled()
* @see #setRowHeight(int, int)
*/
public void setRowHeightEnabled(boolean enabled) {
// PENDING: should we throw an Exception if the enabled fails?
// Or silently fail - depends on runtime context,
// can't do anything about it.
boolean old = isRowHeightEnabled();
if (old == enabled)
return;
if (enabled && !canEnableRowHeight())
return;
rowHeightEnabled = enabled;
if (!enabled) {
adminSetRowHeight(getRowHeight());
}
firePropertyChange("rowHeightEnabled", old, rowHeightEnabled);
}
/**
* Returns a boolean to indicate whether individual row height is enabled.
*
* @return a boolean to indicate whether individual row height support is
* enabled.
* @see #setRowHeightEnabled(boolean)
* @see #setRowHeight(int, int)
*/
public boolean isRowHeightEnabled() {
return rowHeightEnabled;
}
/**
* Returns if it's possible to enable individual row height support.
*
* @return a boolean to indicate whether access of super's private
* rowModel is allowed.
*/
private boolean canEnableRowHeight() {
return getRowModelField() != null;
}
/**
* Returns super's private rowModel which holds the
* individual rowHeights. This method will return null if the
* access failed, f.i. in sandbox restricted applications.
*
* @return super's rowModel field or null if the access was not successful.
*/
private SizeSequence getSuperRowModel() {
try {
Field field = getRowModelField();
if (field != null) {
return (SizeSequence) field.get(this);
}
} catch (SecurityException e) {
LOG.fine("cannot use reflection "
+ " - expected behaviour in sandbox");
} catch (IllegalArgumentException e) {
LOG
.fine("problem while accessing super's private field - private api changed?");
} catch (IllegalAccessException e) {
LOG
.fine("cannot access private field "
+ " - expected behaviour in sandbox. "
+ "Could be program logic running wild in unrestricted contexts");
}
return null;
}
/**
* Returns super's private field which holds the individual rowHeights. This
* method will return null if the access failed, f.i. in
* sandbox restricted applications.
*
* @return the super's field with access allowed or null if an Exception
* caught while trying to access.
*/
private Field getRowModelField() {
if (rowModelField == null) {
try {
rowModelField = JTable.class.getDeclaredField("rowModel");
rowModelField.setAccessible(true);
} catch (SecurityException e) {
rowModelField = null;
LOG.fine("cannot access JTable private field rowModel "
+ "- expected behaviour in sandbox");
} catch (NoSuchFieldException e) {
LOG.fine("problem while accessing super's private field"
+ " - private api changed?");
}
}
return rowModelField;
}
/**
* Returns the mapper used synch individual rowHeights in view/model
* coordinates.
*
* @return the SizeSequenceMapper used to synch view/model
* coordinates for individual row heights
* @see org.jdesktop.swingx.decorator.SizeSequenceMapper
*/
protected SizeSequenceMapper getRowModelMapper() {
if (rowModelMapper == null) {
rowModelMapper = new SizeSequenceMapper(filters);
}
return rowModelMapper;
}
/**
* Sets the rowHeight for all rows to the given value. Keeps the flag
* isXTableRowHeight unchanged. This enables the distinction
* between setting the height for internal reasons from doing so by client
* code.
*
* @param rowHeight new height in pixel.
* @see #setRowHeight(int)
* @see #isXTableRowHeightSet
*/
protected void adminSetRowHeight(int rowHeight) {
boolean heightSet = isXTableRowHeightSet;
setRowHeight(rowHeight);
isXTableRowHeightSet = heightSet;
}
/**
* Tries its best to updateUI of the potential
* TableCellEditor.
*
* @param maybeEditor the potential editor.
*/
private void updateEditorUI(Object maybeEditor) {
// maybe null or proxyValue
if (!(maybeEditor instanceof TableCellEditor))
return;
// super handled this
if ((maybeEditor instanceof JComponent)
|| (maybeEditor instanceof DefaultCellEditor))
return;
// custom editors might balk about fake rows/columns
try {
Component comp = ((TableCellEditor) maybeEditor)
.getTableCellEditorComponent(this, null, false, -1, -1);
if (comp instanceof JComponent) {
((JComponent) comp).updateUI();
}
} catch (Exception e) {
// ignore - can't do anything
}
}
/**
* Tries its best to updateUI of the potential
* TableCellRenderer.
*
* @param maybeRenderer the potential renderer.
*/
private void updateRendererUI(Object maybeRenderer) {
// maybe null or proxyValue
if (!(maybeRenderer instanceof TableCellRenderer))
return;
// super handled this
if (maybeRenderer instanceof JComponent)
return;
// custom editors might balk about fake rows/columns
try {
Component comp = ((TableCellRenderer) maybeRenderer)
.getTableCellRendererComponent(this, null, false, false,
-1, -1);
if (comp instanceof JComponent) {
((JComponent) comp).updateUI();
}
} catch (Exception e) {
// ignore - can't do anything
}
}
// ---------------------------- overriding super factory methods and buggy
/**
* {@inheritDoc}
*
* Overridden to work around core Bug (ID #6291631): negative y is mapped to
* row 0).
*
*/
@Override
public int rowAtPoint(Point point) {
if (point.y < 0)
return -1;
return super.rowAtPoint(point);
}
/**
*
* {@inheritDoc}
*
*
* Overridden to return a JXTableHeader.
* @see JXTableHeader
*/
@Override
protected JTableHeader createDefaultTableHeader() {
return new JXTableHeader(columnModel);
}
/**
*
* {@inheritDoc}
*
*
* Overridden to return a DefaultTableColumnModelExt.
* @see org.jdesktop.swingx.table.DefaultTableColumnModelExt
*/
@Override
protected TableColumnModel createDefaultColumnModel() {
return new DefaultTableColumnModelExt();
}
/**
* {@inheritDoc}
* Overridden because super throws NPE on null param.
*/
@Override
public void setSelectionBackground(Color selectionBackground) {
Color old = getSelectionBackground();
this.selectionBackground = selectionBackground;
firePropertyChange("selectionBackground", old, getSelectionBackground());
repaint();
// super.setSelectionBackground(selectionBackground);
}
/**
* {@inheritDoc}
* Overridden because super throws NPE on null param.
*/
@Override
public void setSelectionForeground(Color selectionForeground) {
Color old = getSelectionForeground();
this.selectionForeground = selectionForeground;
firePropertyChange("selectionForeground", old, getSelectionForeground());
repaint();
}
}