Интерфейс CellEditor

Все известные подинтерфейсы:: TableCellEditor, TreeCellEditor

Все известные реализующие классы:: AbstractCellEditor, DefaultCellEditor, DefaultTreeCellEditor

public interface CellEditor

Этот интерфейс определяет методы, которые должен реализовывать любой общий редактор.

Наличие этого интерфейса позволяет сложным компонентам (клиенту редактора), таким как JTree и JTable, разрешать любому общему редактору редактировать значения в ячейке таблицы или ячейке дерева и т. д. Без этого общего интерфейса редактора JTable пришлось бы знать о конкретных редакторах, таких как JTextField, JCheckBox, JComboBox, и т. д. Кроме того, без этого интерфейса клиенты редакторов, таких как JTable, не смогут работать с любыми редакторами, разработанными в будущем пользователем или сторонним поставщиком ПО (ISV).

Для использования этого интерфейса разработчик, создающий новый редактор, может заставить новый компонент реализовать интерфейс. Или разработчик может выбрать подход на основе обёртки и предоставить связанный объект, который реализует интерфейс CellEditor (см. DefaultCellEditor в качестве примера). Подход на основе обёртки особенно полезен, если пользователь хочет использовать редактор стороннего поставщика ПО (ISV) с JTable, но поставщик ПО (ISV) не реализовал интерфейс CellEditor. Пользователь может просто создать объект, содержащий экземпляр объекта редактора стороннего поставщика ПО и «перевести» API CellEditor в API редактора стороннего поставщика ПО.

С момента:: 1.2
См. также:: 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, установлен. Этот метод предназначен для использования клиентом, чтобы избежать затрат на настройку и установку компонента редактора, если редактирование невозможно. Если редактирование может быть начато, этот метод возвращает 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