gate.gui

Class AlternatingTableCellEditor

java.lang.Object

gate.gui.AlternatingTableCellEditor

All Implemented Interfaces:

CellEditor, TableCellEditor

public class AlternatingTableCellEditor
extends Object
implements TableCellEditor

Table cell editor which delegates to a number of other editors, switching between them in round-robin fashion on each call to getTableCellEditorComponent(javax.swing.JTable, java.lang.Object, boolean, int, int). This works around rendering issues that occur particularly with JComboBox-based cell editors when you try to switch between cells on different rows that would be edited using the same JComboBox object, and the "pop-down" of the combo box from the previously-edited row is not properly sequenced with the change of model and pop-up on the subsequently-edited row.

This class is not thread-safe, but all the method calls happen on the EDT anyway so it doesn't have to be.

The behaviour of this class is as follows:

• The add/remove listener methods are passed through to all of the underlying editors, so listeners will receive events from any of them
• The "current editor" is stepped along the provided array at each call to getTableCellEditorComponent - consecutive calls to this method will be forwarded to different underlying editor instances
• All other methods forward to whichever editor handled the most recent getTableCellEditorComponent call.

Constructor Summary

Constructors

Constructor and Description
AlternatingTableCellEditor(TableCellEditor... editors) Create an AlternatingTableCellEditor that delegates to the specified other editors in round robin order.

Method Summary

Modifier and Type	Method and Description
void	addCellEditorListener(CellEditorListener l) Add the specified listener to all the delegate editors.
void	cancelCellEditing()
Object	getCellEditorValue()
Component	getTableCellEditorComponent(JTable table, Object value, boolean isSelected, int row, int column) Switches focus to the next cell editor in the provided list, and then passes on the call to that editor.
boolean	isCellEditable(EventObject anEvent)
void	removeCellEditorListener(CellEditorListener l) Remove the specified listener from all the delegate editors.
boolean	shouldSelectCell(EventObject anEvent)
boolean	stopCellEditing()

Methods inherited from class java.lang.Object

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

Constructor Detail

AlternatingTableCellEditor

public AlternatingTableCellEditor(TableCellEditor... editors)

Create an AlternatingTableCellEditor that delegates to the specified other editors in round robin order. For a sensible user experience all the delegate editors should have identical behaviour (they would typically be several instances of the same class constructed with the same arguments).

Parameters:

editors - the underlying editors to which we will delegate.

Method Detail

getTableCellEditorComponent

public Component getTableCellEditorComponent(JTable table,
                                             Object value,
                                             boolean isSelected,
                                             int row,
                                             int column)

Switches focus to the next cell editor in the provided list, and then passes on the call to that editor.

Specified by:

getTableCellEditorComponent in interface TableCellEditor

Parameters:

table - the table being edited

value - the current value of the cell being edited

isSelected - true if the cell is to be rendered with highlighting

row - the row index of the cell being edited

column - the column index of the cell being edited

Returns:

a component capable of editing the specified cell

getCellEditorValue

public Object getCellEditorValue()

Specified by:

getCellEditorValue in interface CellEditor

isCellEditable

public boolean isCellEditable(EventObject anEvent)

Specified by:

isCellEditable in interface CellEditor

shouldSelectCell

public boolean shouldSelectCell(EventObject anEvent)

Specified by:

shouldSelectCell in interface CellEditor

stopCellEditing

public boolean stopCellEditing()

Specified by:

stopCellEditing in interface CellEditor

cancelCellEditing

public void cancelCellEditing()

Specified by:

cancelCellEditing in interface CellEditor

addCellEditorListener

public void addCellEditorListener(CellEditorListener l)

Add the specified listener to all the delegate editors.

Specified by:

addCellEditorListener in interface CellEditor

Parameters:

l - the listener to add

removeCellEditorListener

public void removeCellEditorListener(CellEditorListener l)

Remove the specified listener from all the delegate editors.

Specified by:

removeCellEditorListener in interface CellEditor

Parameters:

l - the listener to remove.