javax.swing

Интерфейс CellEditor

Все Известные Подынтерфейсы:

TableCellEditor, TreeCellEditor

Все Известные Классы с реализацией:

AbstractCellEditor, DefaultCellEditor, DefaultTreeCellEditor

public interface CellEditor

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

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

Чтобы использовать этот интерфейс, у разработчика, создающего нового редактора, может быть новая компонентная реализация интерфейс. Или разработчик может выбрать обертку базируемый подход и обеспечить сопутствующий объект, который реализует CellEditor интерфейс (См. JCellEditor например). Подход обертки особенно полезен, если пользователь хочет использовать 3-ьего редактора ISV стороны с JTable, но ISV не реализовывал CellEditor интерфейс. Пользователь может просто создать объект, который содержит экземпляр 3-ьего редактора стороны, возражают и "преобразовывают" CellEditor API в 3-ий API редактора стороны.

См. Также:

CellEditorListener

Сводка метода

Модификатор и Тип	Метод и Описание
void	addCellEditorListener(CellEditorListener l) Добавляет слушатель списка, это уведомляется, когда редактор останавливается, или редактирование отмен.
void	cancelCellEditing() Говорит редактору отменять редактирование и не принимать любое частично отредактированное значение.
Объект	getCellEditorValue() Возвращает значение, содержавшееся в редакторе.
boolean	isCellEditable(EventObject anEvent) Спрашивает редактор, если это может начать редактировать использование anEvent.
void	removeCellEditorListener(CellEditorListener l) Удаляет слушателя из списка, это уведомляется
boolean	shouldSelectCell(EventObject anEvent) Возвращает true, если ячейка редактирования должна быть выбрана, ложь иначе.
boolean	stopCellEditing() Говорит редактору прекращать редактировать и принимать любое частично отредактированное значение как значение редактора.

Деталь метода

getCellEditorValue

Object getCellEditorValue()

Возвращает значение, содержавшееся в редакторе.

Возвраты:

значение содержится в редакторе

isCellEditable

boolean isCellEditable(EventObject anEvent)

Спрашивает редактор, если это может начать редактировать использование anEvent. anEvent находится в компонентной системе координат вызова. Редактор не может принять Компонент, возвращенный getCellEditorComponent устанавливается. Этот метод предназначается для использования клиента, чтобы избежать стоимости установки и установки компонента редактора, если редактирование не возможно. Если редактирование может быть запущено, этот метод возвращает true.

Параметры:

anEvent - событие, которое редактор должен использовать, чтобы рассмотреть, начать ли редактировать или нет

Возвраты:

истина, если редактирование может быть запущено

См. Также:

shouldSelectCell(java.util.EventObject)

shouldSelectCell

boolean shouldSelectCell(EventObject anEvent)

Возвращает true, если ячейка редактирования должна быть выбрана, ложь иначе. Как правило, возвращаемое значение является истиной, потому что, большинство случается, ячейка редактирования должна быть выбрана. Однако, полезно возвратить false, чтобы препятствовать выбору изменяться для некоторых типов редактирований. eg. Таблица, которая содержит столбец флажков, пользователь, могла бы хотеть быть в состоянии изменить те флажки, не изменяя выбор. (См. Netscape Communicator для только такого примера), Конечно, это до клиента редактора, чтобы использовать возвращаемое значение, но это не нуждается к тому, если это не хочет к.

Параметры:

anEvent - событие редактор должно использовать, чтобы начать редактировать

Возвраты:

истина, если редактор хотел бы, чтобы ячейка редактирования была выбрана; иначе возвращает false

См. Также:

isCellEditable(java.util.EventObject)

stopCellEditing

boolean stopCellEditing()

Говорит редактору прекращать редактировать и принимать любое частично отредактированное значение как значение редактора. Редактор возвращает false, если редактирование не было остановлено; это полезно для редакторов, которые проверяют и не могут принять недопустимые записи.

Возвраты:

истина, если редактирование было остановлено; ложь иначе

cancelCellEditing

void cancelCellEditing()

Говорит редактору отменять редактирование и не принимать любое частично отредактированное значение.

addCellEditorListener

void addCellEditorListener(CellEditorListener l)

Добавляет слушатель списка, это уведомляется, когда редактор останавливается, или редактирование отмен.

Параметры:

l - CellEditorListener

removeCellEditorListener

void removeCellEditorListener(CellEditorListener l)

Удаляет слушателя из списка, это уведомляется

Параметры:

l - CellEditorListener