net.sf.cuf.ui.table

Class OptimalColumnWidthSupport

java.lang.Object

java.awt.event.MouseAdapter

net.sf.cuf.ui.table.OptimalColumnWidthSupport

All Implemented Interfaces:

MouseListener, MouseMotionListener, MouseWheelListener, PropertyChangeListener, EventListener

public class OptimalColumnWidthSupport
extends MouseAdapter
implements PropertyChangeListener

Add-on for a JTable to easily set a table column to an optimal width. The optimal width is defined as the maximum length of the currently displayed header and table cell values. The setting of optimal colunm widths works best on tables with JTable.AUTO_RESIZE_OFF.

This class offers two functionalities:

• You can use the static method adjustToOptimalColumnWidth(JTable,int) to set any column of any table to its optimal width.
• You can bind an instance of this class to a table which will react on double clicks in the resize area between table columns to adjust the size of the left column. Only resizable columns will be changed

Author:

Hendrik Wördehoff, sd&m AG

Constructor Summary

Constructors

Constructor and Description
OptimalColumnWidthSupport(JTable pTable) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static void	adjustToOptimalColumnWidth(JTable pTable) Adjust the width of all columns of the table.
static void	adjustToOptimalColumnWidth(JTable pTable, int pViewIndex) Adjust the width of a column.
void	dispose() Disconnect from our table.
void	mousePressed(MouseEvent pEvent) We react on the second mouse press to profit from JTableHeader.getResizingColumn() which is no longer set when the mouse click event occurs.
void	propertyChange(PropertyChangeEvent pEvent) We need to notice when the table header is changed so that we can move the mouse listener to the new header.

Methods inherited from class java.awt.event.MouseAdapter

mouseClicked, mouseDragged, mouseEntered, mouseExited, mouseMoved, mouseReleased, mouseWheelMoved

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OptimalColumnWidthSupport

public OptimalColumnWidthSupport(JTable pTable)

Constructor. Registers this instance as a mouse listener for double clicks on the resize area oof the table header. Also registers as a property change listener in case the header of the table is changed.

Parameters:

pTable - table to work on

Method Detail

dispose

public void dispose()

Disconnect from our table. Use this method if you need to get rid of this instance.

adjustToOptimalColumnWidth

public static void adjustToOptimalColumnWidth(JTable pTable)

Adjust the width of all columns of the table.

Parameters:

pTable - table to work on

Throws:

IllegalArgumentException - if table is null

adjustToOptimalColumnWidth

public static void adjustToOptimalColumnWidth(JTable pTable,
                              int pViewIndex)

Adjust the width of a column. This method will do nothing if the index is not a valid column index.

Parameters:

pTable - table to work on

pViewIndex - view column index

Throws:

IllegalArgumentException - if table is null

propertyChange

public void propertyChange(PropertyChangeEvent pEvent)

We need to notice when the table header is changed so that we can move the mouse listener to the new header.

Specified by:

propertyChange in interface PropertyChangeListener

Parameters:

pEvent - table header change event

mousePressed

public void mousePressed(MouseEvent pEvent)

We react on the second mouse press to profit from JTableHeader.getResizingColumn() which is no longer set when the mouse click event occurs.

Specified by:

mousePressed in interface MouseListener

Overrides:

mousePressed in class MouseAdapter

Parameters:

pEvent - mouse event