CellEditor - [ Java参考文档 ] - 在线原生手册

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.swing
接口 CellEditor

所有已知子接口：: TableCellEditor, TreeCellEditor

所有已知实现类：: AbstractCellEditor, DefaultCellEditor, DefaultTreeCellEditor

public interface CellEditor

此接口定义任何通用编辑器应该能够实现的方法。

让此接口启用复杂组件（编辑器的客户端），比如 JTree 和 JTable，从而允许任何一般编辑器编辑表单元格值、树单元格值等等。如果没有此一般编辑器接口，则 JTable 不得不了解特定编辑器，比如 JTextField、JCheckBox、JComboBox 等等。此外，如果没有此接口，则编辑器（如 JTable）的客户端无法使用用户或第三方 ISV 将来开发的其他任何编辑器。

要使用此接口，创建新编辑器的开发人员可以用新的组件实现该接口。或者开发人员可以选择一个基于包装器的方法，提供一个实现 CellEditor 接口的辅助对象（请参见 JCellEditor 获取示例）。如果用户想将第三方 ISV 编辑器用于 JTable，但该 ISV 没有实现 CellEditor 接口，则包装器方法特别有用。用户可以只创建一个包含第三方编辑器对象实例的对象，并将 CellEditor API“转换”成第三方编辑器的 API。

另请参见：: CellEditorListener

方法摘要
`void`	`addCellEditorListener(CellEditorListener l)` 当编辑器停止运作或取消编辑时，向被通知的列表添加一个侦听器。
`void`	`cancelCellEditing()` 告知编辑器取消编辑并且不接受任何已部分编辑的值。
`Object`	`getCellEditorValue()` 返回编辑器中包含的值。
`boolean`	`isCellEditable(EventObject anEvent)` 询问编辑器它是否可以使用 `anEvent` 开始进行编辑。
`void`	`removeCellEditorListener(CellEditorListener l)` 从被通知的列表中移除一个侦听器
`boolean`	`shouldSelectCell(EventObject anEvent)` 如果应该选择正编辑的单元格，则返回 true，否则返回 false。
`boolean`	`stopCellEditing()` 告知编辑器停止编辑并接受任何已部分编辑的值作为编辑器的值。

方法详细信息

getCellEditorValue

Object getCellEditorValue()

返回编辑器中包含的值。

返回：: 编辑器中包含的值

isCellEditable

boolean isCellEditable(EventObject anEvent)

询问编辑器它是否可以使用 anEvent 开始进行编辑。anEvent 在将要调用的组件的坐标系统中。编辑器不能假定由 getCellEditorComponent 返回的 Component 已被安装。此方法供客户端使用，以避免不可能进行编辑时设置和安装编辑器组件所带来的花费。如果可以开始进行编辑，则此方法返回 true。

参数：: anEvent - 编辑器考虑是否开始进行编辑时应该使用的事件
返回：: 如果可开始进行编辑，则返回 true
另请参见：: shouldSelectCell(java.util.EventObject)

shouldSelectCell

boolean shouldSelectCell(EventObject anEvent)

如果应该选择正编辑的单元格，则返回 true，否则返回 false。通常，返回的值为 true，因为大多数情况下都应该选择正编辑的单元格。不过，通过返回 false 可以使选择不受某些类型的编辑更改的影响。例如，对于包含一列复选框的表，用户也许想在不改变选择的情况下能够更改这些复选框。（请参见 Netscape Communicator 来获得这样的示例）当然，这取决于编辑器的客户端是否使用返回的值，但是，如果它不想使用返回值的话，则不必使用。

参数：: anEvent - 编辑器开始进行编辑时应该使用的事件
返回：: 如果编辑器愿意选择正编辑的单元格，则返回 true；否则返回 false
另请参见：: isCellEditable(java.util.EventObject)

stopCellEditing

boolean stopCellEditing()

告知编辑器停止编辑并接受任何已部分编辑的值作为编辑器的值。如果编辑没有停止，则编辑器返回 false；这对已生效并且无法接受无效条目的编辑器很有用。

返回：: 如果编辑已停止，则返回 true；否则返回 false

cancelCellEditing

void cancelCellEditing()

告知编辑器取消编辑并且不接受任何已部分编辑的值。

addCellEditorListener

void addCellEditorListener(CellEditorListener l)

当编辑器停止运作或取消编辑时，向被通知的列表添加一个侦听器。

参数：: l - CellEditorListener

removeCellEditorListener

void removeCellEditorListener(CellEditorListener l)

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

参数：: l - CellEditorListener

概述