DefaultCellEditor (Java 2 Platform SE 5.0) (original) (raw)

javax.swing

Class DefaultCellEditor

java.lang.Object extended by javax.swing.AbstractCellEditor javax.swing.DefaultCellEditor

All Implemented Interfaces:

Serializable, CellEditor, TableCellEditor, TreeCellEditor

public class DefaultCellEditor

extends AbstractCellEditor

implements TableCellEditor, TreeCellEditor

The default editor for table and tree cells.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeansTM has been added to the java.beans package. Please see XMLEncoder.

Nested Class Summary
protected class	DefaultCellEditor.EditorDelegate The protected EditorDelegate class.

Field Summary
protected int	clickCountToStart An integer specifying the number of clicks needed to start editing.
protected DefaultCellEditor.EditorDelegate	delegate The delegate class which handles all methods sent from theCellEditor.
protected JComponent	editorComponent The Swing component being edited.

Fields inherited from class javax.swing.AbstractCellEditor
changeEvent, listenerList

Constructor Summary
DefaultCellEditor(JCheckBox checkBox) Constructs a DefaultCellEditor object that uses a check box.
DefaultCellEditor(JComboBox comboBox) Constructs a DefaultCellEditor object that uses a combo box.
DefaultCellEditor(JTextField textField) Constructs a DefaultCellEditor that uses a text field.

Method Summary
void	cancelCellEditing() Forwards the message from the CellEditor to the delegate.
Object	getCellEditorValue() Forwards the message from the CellEditor to the delegate.
int	getClickCountToStart() Returns the number of clicks needed to start editing.
Component	getComponent() Returns a reference to the editor component.
Component	[getTableCellEditorComponent](../../javax/swing/DefaultCellEditor.html#getTableCellEditorComponent%28javax.swing.JTable, java.lang.Object, boolean, int, int%29)(JTable table,Object value, boolean isSelected, int row, int column) Implements the TableCellEditor interface.
Component	[getTreeCellEditorComponent](../../javax/swing/DefaultCellEditor.html#getTreeCellEditorComponent%28javax.swing.JTree, java.lang.Object, boolean, boolean, boolean, int%29)(JTree tree,Object value, boolean isSelected, boolean expanded, boolean leaf, int row) Implements the TreeCellEditor interface.
boolean	isCellEditable(EventObject anEvent) Forwards the message from the CellEditor to the delegate.
void	setClickCountToStart(int count) Specifies the number of clicks needed to start editing.
boolean	shouldSelectCell(EventObject anEvent) Forwards the message from the CellEditor to the delegate.
boolean	stopCellEditing() Forwards the message from the CellEditor to the delegate.

Methods inherited from class javax.swing.AbstractCellEditor
addCellEditorListener, fireEditingCanceled, fireEditingStopped, getCellEditorListeners, removeCellEditorListener

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, [wait](../../java/lang/Object.html#wait%28long, int%29)

Methods inherited from interface javax.swing.CellEditor
addCellEditorListener, removeCellEditorListener

Methods inherited from interface javax.swing.CellEditor
addCellEditorListener, removeCellEditorListener

Field Detail

editorComponent

protected JComponent editorComponent

The Swing component being edited.

delegate

protected DefaultCellEditor.EditorDelegate delegate

The delegate class which handles all methods sent from theCellEditor.

clickCountToStart

protected int clickCountToStart

An integer specifying the number of clicks needed to start editing. Even if clickCountToStart is defined as zero, it will not initiate until a click occurs.

Constructor Detail

DefaultCellEditor

public DefaultCellEditor(JTextField textField)

Constructs a DefaultCellEditor that uses a text field.

Parameters:

textField - a JTextField object

DefaultCellEditor

public DefaultCellEditor(JCheckBox checkBox)

Constructs a DefaultCellEditor object that uses a check box.

Parameters:

checkBox - a JCheckBox object

DefaultCellEditor

public DefaultCellEditor(JComboBox comboBox)

Constructs a DefaultCellEditor object that uses a combo box.

Parameters:

comboBox - a JComboBox object

Method Detail

getComponent

public Component getComponent()

Returns a reference to the editor component.

Returns:

the editor Component

setClickCountToStart

public void setClickCountToStart(int count)

Specifies the number of clicks needed to start editing.

Parameters:

count - an int specifying the number of clicks needed to start editing

See Also:

getClickCountToStart()

getClickCountToStart

public int getClickCountToStart()

Returns the number of clicks needed to start editing.

Returns:

the number of clicks needed to start editing

getCellEditorValue

public Object getCellEditorValue()

Forwards the message from the CellEditor to the delegate.

Specified by:

[getCellEditorValue](../../javax/swing/CellEditor.html#getCellEditorValue%28%29) in interface [CellEditor](../../javax/swing/CellEditor.html "interface in javax.swing")

Returns:

the value contained in the editor

isCellEditable

public boolean isCellEditable(EventObject anEvent)

Forwards the message from the CellEditor to the delegate.

Specified by:

[isCellEditable](../../javax/swing/CellEditor.html#isCellEditable%28java.util.EventObject%29) in interface [CellEditor](../../javax/swing/CellEditor.html "interface in javax.swing")

Overrides:

[isCellEditable](../../javax/swing/AbstractCellEditor.html#isCellEditable%28java.util.EventObject%29) in class [AbstractCellEditor](../../javax/swing/AbstractCellEditor.html "class in javax.swing")

Parameters:

anEvent - an event object

Returns:

true

shouldSelectCell

public boolean shouldSelectCell(EventObject anEvent)

Forwards the message from the CellEditor to the delegate.

Specified by:

[shouldSelectCell](../../javax/swing/CellEditor.html#shouldSelectCell%28java.util.EventObject%29) in interface [CellEditor](../../javax/swing/CellEditor.html "interface in javax.swing")

Overrides:

[shouldSelectCell](../../javax/swing/AbstractCellEditor.html#shouldSelectCell%28java.util.EventObject%29) in class [AbstractCellEditor](../../javax/swing/AbstractCellEditor.html "class in javax.swing")

Parameters:

anEvent - an event object

Returns:

true

stopCellEditing

public boolean stopCellEditing()

Forwards the message from the CellEditor to the delegate.

Specified by:

[stopCellEditing](../../javax/swing/CellEditor.html#stopCellEditing%28%29) in interface [CellEditor](../../javax/swing/CellEditor.html "interface in javax.swing")

Overrides:

[stopCellEditing](../../javax/swing/AbstractCellEditor.html#stopCellEditing%28%29) in class [AbstractCellEditor](../../javax/swing/AbstractCellEditor.html "class in javax.swing")

Returns:

true

cancelCellEditing

public void cancelCellEditing()

Forwards the message from the CellEditor to the delegate.

Specified by:

[cancelCellEditing](../../javax/swing/CellEditor.html#cancelCellEditing%28%29) in interface [CellEditor](../../javax/swing/CellEditor.html "interface in javax.swing")

Overrides:

[cancelCellEditing](../../javax/swing/AbstractCellEditor.html#cancelCellEditing%28%29) in class [AbstractCellEditor](../../javax/swing/AbstractCellEditor.html "class in javax.swing")

getTreeCellEditorComponent

public Component getTreeCellEditorComponent(JTree tree, Object value, boolean isSelected, boolean expanded, boolean leaf, int row)

Implements the TreeCellEditor interface.

Specified by:

[getTreeCellEditorComponent](../../javax/swing/tree/TreeCellEditor.html#getTreeCellEditorComponent%28javax.swing.JTree, java.lang.Object, boolean, boolean, boolean, int%29) in interface [TreeCellEditor](../../javax/swing/tree/TreeCellEditor.html "interface in javax.swing.tree")

Parameters:

tree - the JTree that is asking the editor to edit; this parameter can be null

value - the value of the cell to be edited

isSelected - true is the cell is to be renderer with selection highlighting

expanded - true if the node is expanded

leaf - true if the node is a leaf node

row - the row index of the node being edited

Returns:

the component for editing

getTableCellEditorComponent

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

Implements the TableCellEditor interface.

Specified by:

[getTableCellEditorComponent](../../javax/swing/table/TableCellEditor.html#getTableCellEditorComponent%28javax.swing.JTable, java.lang.Object, boolean, int, int%29) in interface [TableCellEditor](../../javax/swing/table/TableCellEditor.html "interface in javax.swing.table")

Parameters:

table - the JTable that is asking the editor to edit; can be null

value - the value of the cell to be edited; it is up to the specific editor to interpret and draw the value. For example, if value is the string "true", it could be rendered as a string or it could be rendered as a check box that is checked. null is a valid value

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

row - the row of the cell being edited

column - the column of the cell being edited

Returns:

the component for editing

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.