javax.swing

Interface CellEditor

All Known Subinterfaces:

TableCellEditor， TreeCellEditor

所有已知实现类：

AbstractCellEditor， DefaultCellEditor， DefaultTreeCellEditor

public interface CellEditor

这个接口定义了任何一般编辑器应该能够实现的方法。

这个接口使复杂的组件（编辑器的客户）如JTree和JTable允许任何通用的编辑器来编辑表格中的单元格的值，或树的细胞，等没有这个通用的编辑器界面，JTable会知道具体的编辑，如JTextField，JCheckBox，JComboBox，等。此外，没有这个界面，编辑如JTable客户不能与任何编辑在未来发展由用户或第三方ISV的工作。

要使用此接口，一个开发人员创建一个新的编辑器可以有新的组件实现接口。或开发人员可以选择一个包装为基础的方法，提供一种实现CellEditor接口配套对象（见JCellEditor为例）。如果用户想使用第三方软件编辑JTable包装方法特别有用，但ISV没有实施CellEditor接口。用户可以简单地创建一个包含第三方编辑对象的一个实例，“翻译”的CellEditor API向第三方编辑器的API。

另请参见：

CellEditorListener

方法摘要

Modifier and Type	Method and Description
void	addCellEditorListener(CellEditorListener l) 将一个侦听器添加到编辑器停止或取消编辑时所通知的列表中。
void	cancelCellEditing() 告诉编辑器取消编辑，不接受任何部分编辑的值。
Object	getCellEditorValue() 返回编辑器中包含的值。
boolean	isCellEditable(EventObject anEvent) 请编辑如果可以开始编辑使用 anEvent。
void	removeCellEditorListener(CellEditorListener l) 从通知的列表中移除一个侦听器
boolean	shouldSelectCell(EventObject anEvent) 如果编辑单元格应该被选中，则返回真，否则会被错误的。
boolean	stopCellEditing() 告诉编辑器停止编辑，并接受任何部分编辑的值作为编辑器的值。

方法详细信息

getCellEditorValue

Object getCellEditorValue()

返回编辑器中包含的值。

结果

编辑器中包含的值

isCellEditable

boolean isCellEditable(EventObject anEvent)

请编辑如果可以开始编辑使用 anEvent。 anEvent在调用组件的坐标系统。编辑可以不承担安装的组件返回的 getCellEditorComponent。此方法的目的是为使用客户端，以避免设置和安装编辑器组件的成本，如果编辑是不可能的。如果编辑可以开始此方法返回真实。

参数

anEvent -编辑应该考虑是否开始编辑或不活动

结果

真正的，如果编辑可以开始

另请参见：

shouldSelectCell(java.util.EventObject)

shouldSelectCell

boolean shouldSelectCell(EventObject anEvent)

如果编辑单元格应该被选中，则返回真，否则会被错误的。通常情况下，返回值是真的，因为大多数情况下，编辑单元应该被选择。然而，它是有用的返回错误，保持从改变的选择一些类型的编辑。一个表包含一列复选框，用户可能希望能够改变那些不改变选择的复选框。（参阅Netscape Communicator这样的一个例子）当然，这是向编辑客户端使用返回值，但是它不需要如果不想。

参数

anEvent -编辑应使用开始编辑事件

结果

如果编辑器想选择要选择的编辑单元，则为真；否则返回错误

另请参见：

isCellEditable(java.util.EventObject)

stopCellEditing

boolean stopCellEditing()

告诉编辑器停止编辑，并接受任何部分编辑的值作为编辑器的值。如果编辑未被停止，则编辑器返回错误；这对验证和不能接受无效条目的编辑器是有用的。

结果

如果编辑停止，则为真；否则为假

cancelCellEditing

void cancelCellEditing()

告诉编辑器取消编辑，不接受任何部分编辑的值。

addCellEditorListener

void addCellEditorListener(CellEditorListener l)

将一个侦听器添加到编辑器停止或取消编辑时所通知的列表中。

参数

l - CellEditorListener

removeCellEditorListener

void removeCellEditorListener(CellEditorListener l)

从通知的列表中移除一个侦听器

参数

l - CellEditorListener