Интерфейс 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

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`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

boolean shouldSelectCell(EventObject anEvent)

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

Параметры:

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

Возвращает:

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

См. также:

stopCellEditing

boolean stopCellEditing()

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

Возвращает:: true, если редактирование было остановлено; false в противном случае

cancelCellEditing

void cancelCellEditing()

Указывает редактору отменить редактирование и не принимать никакое частично отредактированное значение.

addCellEditorListener

void addCellEditorListener(CellEditorListener l)

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

Параметры:: l - CellEditorListener

removeCellEditorListener

void removeCellEditorListener(CellEditorListener l)

Удаляет слушателя из списка, который уведомляется.

Параметры:: l - CellEditorListener

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/CellEditor.html