Класс DefaultTreeCellEditor

java.lang.Object

javax.swing.tree.DefaultTreeCellEditor

Все реализованные интерфейсы:: ActionListener, EventListener, CellEditor, TreeSelectionListener, TreeCellEditor

public class DefaultTreeCellEditor extends Object implements ActionListener, TreeCellEditor, TreeSelectionListener

TreeCellEditor. Необходимо предоставить экземпляр DefaultTreeCellRenderer, чтобы получить значки. При желании можно предоставить TreeCellEditor, который будет размещен в соответствии со значком в DefaultTreeCellRenderer. Если TreeCellEditor не предоставлен, будет использоваться TextField. Редактирование начинается при тройном щелчке мышью или после щелчка, паузы, повторного щелчка и задержки в 1200 миллисекунд.

Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими выпусками Swing. Текущая поддержка сериализации предназначена для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`class`	`DefaultTreeCellEditor.DefaultTextField`	`TextField`, используемый, если редактор не предоставлен.
`class`	`DefaultTreeCellEditor.EditorContainer`	Контейнер, отвечающий за размещение `editingComponent`.

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected Color`	`borderSelectionColor`	Значение true, если необходимо отображать цвет выделения границы.
`protected boolean`	`canEdit`	Начиная с платформы Java 2 версии 1.4 это поле не следует использовать.
`protected Component`	`editingComponent`	Компонент, используемый при редактировании и получаемый из `editingContainer`.
`protected Container`	`editingContainer`	Контейнер редактирования, содержащий `editorComponent`.
`protected Icon`	`editingIcon`	Значок, используемый при редактировании.
`protected Font`	`font`	Шрифт для отрисовки; `null` указывает, что следует использовать шрифт средства отображения.
`protected TreePath`	`lastPath`	Последний выбранный путь.
`protected int`	`lastRow`	Строка, последняя переданная в `getTreeCellEditorComponent`.
`protected int`	`offset`	Используется при редактировании.
`protected TreeCellEditor`	`realEditor`	Редактор, выполняющий редактирование.
`protected DefaultTreeCellRenderer`	`renderer`	Средство отображения, из которого извлекаются граница и смещения.
`protected Timer`	`timer`	Используется перед началом сеанса редактирования.
`protected JTree`	`tree`	Экземпляр `JTree`, также прослушивающий события.

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

Конструктор	Описание
`DefaultTreeCellEditor(JTree tree, DefaultTreeCellRenderer renderer)`	Создает объект `DefaultTreeCellEditor` для JTree, используя указанные средство отображения и редактор по умолчанию.
`DefaultTreeCellEditor(JTree tree, DefaultTreeCellRenderer renderer, TreeCellEditor editor)`	Создает объект `DefaultTreeCellEditor` для `JTree`, используя указанные средство отображения и редактор.

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

Модификатор и тип	Метод	Описание
`void`	`actionPerformed(ActionEvent e)`	Вызывается при срабатывании таймера и запускает сеанс редактирования.
`void`	`addCellEditorListener(CellEditorListener l)`	Добавляет `CellEditorListener`.
`void`	`cancelCellEditing()`	Отправляет `cancelCellEditing` в `realEditor` и удаляет его из этого экземпляра.
`protected boolean`	`canEditImmediately(EventObject event)`	Возвращает true, если `event` является `null` или если это `MouseEvent` со счетчиком щелчков > 2 и `inHitRegion` возвращает true.
`protected Container`	`createContainer()`	Создает контейнер для управления размещением `editingComponent`.
`protected TreeCellEditor`	`createTreeCellEditor()`	Вызывается, если `TreeCellEditor` не передан конструктору.
`protected void`	`determineOffset(JTree tree, Object value, boolean isSelected, boolean expanded, boolean leaf, int row)`	Определяет смещение.
`Color`	`getBorderSelectionColor()`	Возвращает цвет, которым отрисовывается граница.
`CellEditorListener[]`	`getCellEditorListeners()`	Возвращает массив всех `CellEditorListener`, добавленных в этот DefaultTreeCellEditor с помощью addCellEditorListener().
`Object`	`getCellEditorValue()`	Возвращает значение, редактируемое в данный момент.
`Font`	`getFont()`	Возвращает шрифт, используемый при редактировании.
`Component`	`getTreeCellEditorComponent(JTree tree, Object value, boolean isSelected, boolean expanded, boolean leaf, int row)`	Настраивает редактор.
`protected boolean`	`inHitRegion(int x, int y)`	Возвращает true, если переданное местоположение является допустимым местом щелчка мышью для начала редактирования.
`boolean`	`isCellEditable(EventObject event)`	Если `realEditor` возвращает true в ответ на это сообщение, вызывается `prepareForEditing` и возвращается true.
`protected void`	`prepareForEditing()`	Вызывается непосредственно перед началом редактирования.
`void`	`removeCellEditorListener(CellEditorListener l)`	Удаляет ранее добавленный `CellEditorListener`.
`void`	`setBorderSelectionColor(Color newColor)`	Устанавливает цвет границы.
`void`	`setFont(Font font)`	Устанавливает шрифт для редактирования.
`protected void`	`setTree(JTree newTree)`	Задает дерево, для которого в данный момент выполняется редактирование.
`boolean`	`shouldSelectCell(EventObject event)`	Запрашивает у `realEditor` возвращаемое значение.
`protected boolean`	`shouldStartEditingTimer(EventObject event)`	Возвращает true, если `event` является `MouseEvent` и счетчик щелчков равен 1.
`protected void`	`startEditingTimer()`	Запускает таймер редактирования.
`boolean`	`stopCellEditing()`	Если `realEditor` разрешает остановить редактирование, `realEditor` удаляется и возвращается true; в противном случае возвращается false.
`void`	`valueChanged(TreeSelectionEvent e)`	Сбрасывает `lastPath`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

realEditor

protected TreeCellEditor realEditor

Редактор, выполняющий редактирование.

renderer

protected DefaultTreeCellRenderer renderer

Средство отображения, из которого извлекаются граница и смещения.

editingContainer

protected Container editingContainer

Контейнер редактирования, содержащий editorComponent.

editingComponent

protected transient Component editingComponent

Компонент, используемый при редактировании и получаемый из editingContainer.

canEdit

protected boolean canEdit

Начиная с платформы Java 2 версии 1.4 это поле не следует использовать. Чтобы обеспечить аналогичное поведение, следует непосредственно переопределить isCellEditable.

offset

protected transient int offset

Используется при редактировании. Указывает позицию x для размещения editingComponent.

tree

protected transient JTree tree

Экземпляр JTree, также прослушивающий события.

lastPath

protected transient TreePath lastPath

Последний выбранный путь.

timer

protected transient Timer timer

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

lastRow

protected transient int lastRow

Строка, последняя переданная в getTreeCellEditorComponent.

borderSelectionColor

protected Color borderSelectionColor

Значение true, если необходимо отображать цвет выделения границы.

editingIcon

protected transient Icon editingIcon

Значок, используемый при редактировании.

font

protected Font font

Шрифт для отрисовки; null указывает, что следует использовать шрифт средства отображения.

Подробное описание конструкторов

DefaultTreeCellEditor

public DefaultTreeCellEditor(JTree tree, DefaultTreeCellRenderer renderer)

Создает объект DefaultTreeCellEditor для JTree, используя указанные средство отображения и редактор по умолчанию. (Используйте этот конструктор для обычного редактирования.)

Параметры:: tree — объект JTree; renderer — объект DefaultTreeCellRenderer

DefaultTreeCellEditor

public DefaultTreeCellEditor(JTree tree, DefaultTreeCellRenderer renderer, TreeCellEditor editor)

Создает объект DefaultTreeCellEditor для JTree, используя указанные средство отображения и редактор. (Используйте этот конструктор для специализированного редактирования.)

Параметры:: tree — объект JTree; renderer — объект DefaultTreeCellRenderer; editor — объект TreeCellEditor

Подробное описание методов

setBorderSelectionColor

public void setBorderSelectionColor(Color newColor)

Устанавливает цвет границы.

Параметры:: newColor — новый цвет границы

getBorderSelectionColor

public Color getBorderSelectionColor()

Возвращает цвет, которым отрисовывается граница.

Возвращает:: цвет выделения границы

setFont

public void setFont(Font font)

Устанавливает шрифт для редактирования. null указывает, что следует использовать шрифт средства отображения. Это НЕ переопределит шрифт, заданный в редакторе, с которым был создан данный экземпляр. Если null для редактора не был передан, будет создан редактор по умолчанию, который будет использовать этот шрифт.

Параметры:

font — шрифт для редактирования Font

См. также:

getFont

public Font getFont()

Возвращает шрифт, используемый при редактировании.

Возвращает:

шрифт для редактирования Font

См. также:

getTreeCellEditorComponent

public Component getTreeCellEditorComponent(JTree tree, Object value, boolean isSelected, boolean expanded, boolean leaf, int row)

Настраивает редактор. Передает данные в realEditor.

Определено в:: getTreeCellEditorComponent в интерфейсе TreeCellEditor
Параметры:: tree — JTree, запрашивающее у редактора редактирование; этот параметр может быть null; value — значение редактируемой ячейки; isSelected — true, если ячейка должна отображаться с подсветкой выделения; expanded — true, если узел развернут; leaf — true, если узел является листовым; row — индекс строки редактируемого узла
Возвращает:: компонент для редактирования

getCellEditorValue

public Object getCellEditorValue()

Возвращает значение, редактируемое в данный момент.

Определено в:: getCellEditorValue в интерфейсе CellEditor
Возвращает:: значение, редактируемое в данный момент

isCellEditable

public boolean isCellEditable(EventObject event)

Если realEditor возвращает true в ответ на это сообщение, вызывается prepareForEditing и возвращается true.

Определено в:

isCellEditable в интерфейсе CellEditor

Параметры:

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

Возвращает:

true, если редактирование можно начать

См. также:

shouldSelectCell

public boolean shouldSelectCell(EventObject event)

Запрашивает у realEditor возвращаемое значение.

Определено в:

shouldSelectCell в интерфейсе CellEditor

Параметры:

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

Возвращает:

true, если редактор желает выбрать редактируемую ячейку; в противном случае возвращает false

См. также:

stopCellEditing

public boolean stopCellEditing()

Если realEditor разрешает остановить редактирование, realEditor удаляется и возвращается true; в противном случае возвращается false.

Определено в:: stopCellEditing в интерфейсе CellEditor
Возвращает:: true, если редактирование остановлено; иначе false

cancelCellEditing

public void cancelCellEditing()

Отправляет cancelCellEditing в realEditor и удаляет его из этого экземпляра.

Определено в:: cancelCellEditing в интерфейсе CellEditor

addCellEditorListener

public void addCellEditorListener(CellEditorListener l)

Добавляет CellEditorListener.

Определено в:: addCellEditorListener в интерфейсе CellEditor
Параметры:: l — добавляемый слушатель

removeCellEditorListener

public void removeCellEditorListener(CellEditorListener l)

Удаляет ранее добавленный CellEditorListener.

Определено в:: removeCellEditorListener в интерфейсе CellEditor
Параметры:: l — удаляемый слушатель

getCellEditorListeners

public CellEditorListener[] getCellEditorListeners()

Возвращает массив всех CellEditorListener, добавленных в этот DefaultTreeCellEditor с помощью addCellEditorListener().

Возвращает:: все CellEditorListener, добавленные в экземпляр, или пустой массив, если слушатели не добавлялись
Начиная с:: 1.4

valueChanged

public void valueChanged(TreeSelectionEvent e)

Сбрасывает lastPath.

Определено в:: valueChanged в интерфейсе TreeSelectionListener
Параметры:: e — событие, описывающее изменение.

actionPerformed

public void actionPerformed(ActionEvent e)

Вызывается при срабатывании таймера и запускает сеанс редактирования.

Определено в:: actionPerformed в интерфейсе ActionListener
Параметры:: e — обрабатываемое событие

setTree

protected void setTree(JTree newTree)

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

Параметры:: newTree — новое дерево для редактирования

shouldStartEditingTimer

protected boolean shouldStartEditingTimer(EventObject event)

Возвращает true, если event является MouseEvent и счетчик щелчков равен 1.

Параметры:: event — проверяемое событие
Возвращает:: следует ли event запускать таймер редактирования

startEditingTimer

protected void startEditingTimer()

Запускает таймер редактирования.

canEditImmediately

protected boolean canEditImmediately(EventObject event)

Возвращает true, если event является null или если это MouseEvent со счетчиком щелчков > 2 и inHitRegion возвращает true.

Параметры:: event — проверяемое событие
Возвращает:: можно ли начать редактирование для данного event

inHitRegion

protected boolean inHitRegion(int x, int y)

Возвращает true, если переданное местоположение является допустимым местом щелчка мышью для начала редактирования. Реализация возвращает false, если x меньше или равна ширине значка и интервала между значками, отображаемых средством отображения. Иными словами, метод возвращает true, если пользователь щелкает по тексту, отображаемому средством отображения, и false в противном случае.

Параметры:: x — координата x точки; y — координата y точки
Возвращает:: true, если переданное местоположение является допустимым местом для щелчка мышью

determineOffset

protected void determineOffset(JTree tree, Object value, boolean isSelected, boolean expanded, boolean leaf, int row)

Определяет смещение.

Параметры:: tree — объект JTree; value — значение; isSelected — состояние выделения; expanded — состояние развертывания; leaf — состояние листового узла; row — текущая строка

prepareForEditing

protected void prepareForEditing()

Вызывается непосредственно перед началом редактирования. Добавляет editingComponent в editingContainer.

createContainer

protected Container createContainer()

Создает контейнер для управления размещением editingComponent.

Возвращает:: новый объект Container

createTreeCellEditor

protected TreeCellEditor createTreeCellEditor()

Вызывается, если TreeCellEditor не передан конструктору. Возвращает редактор TextField.

Возвращает:: новый редактор TextField

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/tree/DefaultTreeCellEditor.html