Класс DefaultTreeCellRenderer
- Все реализуемые интерфейсы:
-
ImageObserver,MenuContainer,Serializable,Accessible,SwingConstants,TreeCellRenderer
public class DefaultTreeCellRenderer extends JLabel implements TreeCellRenderer
DefaultTreeCellRenderer не является непрозрачным, и если вы не переопределяете метод paint, вы не должны изменять это. См. Использование деревьев в учебнике Java для примеров кастомизации отображения узлов с помощью этого класса. Набор иконок и цветов, используемых DefaultTreeCellRenderer, может быть настроен с помощью различных методов установки. Значение каждого свойства инициализируется из таблицы по умолчанию. Когда изменяется вид (вызывается updateUI), любые свойства, имеющие значение типа UIResource, обновляются из таблицы по умолчанию. В следующей таблице показано отображение между свойством DefaultTreeCellRenderer и ключом таблицы по умолчанию:
| Свойство | Ключ |
|---|---|
| "leafIcon" | "Tree.leafIcon" |
| "closedIcon" | "Tree.closedIcon" |
| "openIcon" | "Tree.openIcon" |
| "textSelectionColor" | "Tree.selectionForeground" |
| "textNonSelectionColor" | "Tree.textForeground" |
| "backgroundSelectionColor" | "Tree.selectionBackground" |
| "backgroundNonSelectionColor" | "Tree.textBackground" |
| "borderSelectionColor" | "Tree.selectionBorderColor" |
Примечание об реализации: Этот класс переопределяет invalidate, validate, revalidate, repaint и firePropertyChange только для повышения производительности. Если они не переопределены, эти часто вызываемые методы будут выполнять ненужные действия для стандартного рендерера ячеек дерева. Если вы создаете свой собственный рендерер, тщательно взвесьте преимущества и недостатки переопределения этих методов.
Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. См. XMLEncoder.
Краткое описание вложенных классов
Вложенные классы/интерфейсы, объявленные в классе javax.swing.JLabel
JLabel.AccessibleJLabel
Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent
JComponent.AccessibleJComponent
Вложенные классы/интерфейсы, объявленные в классе java.awt.Container
Container.AccessibleAWTContainer
Вложенные классы/интерфейсы, объявленные в классе java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
protected Color |
backgroundNonSelectionColor |
Цвет фона для невыделенных узлов. |
protected Color |
backgroundSelectionColor |
Цвет фона для выделенных узлов. |
protected Color |
borderSelectionColor |
Цвет индикатора фокуса для узла с фокусом. |
protected Icon |
closedIcon |
Иконка для нерасширенных узлов, которые не являются листьями. |
protected boolean |
hasFocus |
Истина, если имеет фокус. |
protected Icon |
leafIcon |
Иконка для листовых узлов. |
protected Icon |
openIcon |
Иконка для расширенных узлов, которые не являются листьями. |
protected boolean |
selected |
Является ли значение в данный момент выделенным. |
protected Color |
textNonSelectionColor |
Цвет для текста невыделенных узлов. |
protected Color |
textSelectionColor |
Цвет для текста выделенных узлов. |
Поля, объявленные в классе javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Поля, объявленные в классе java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Поля, объявленные в интерфейсе java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Поля, объявленные в интерфейсе javax.swing.SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
DefaultTreeCellRenderer() |
Создает DefaultTreeCellRenderer. |
Краткое описание методов
| Modifier and Type | Метод | Описание |
|---|---|---|
void |
firePropertyChange |
Переопределено для повышения производительности. |
void |
firePropertyChange |
Переопределено для повышения производительности. |
void |
firePropertyChange |
Переопределено для повышения производительности. |
void |
firePropertyChange |
Переопределено для повышения производительности. |
void |
firePropertyChange |
Переопределено для повышения производительности. |
void |
firePropertyChange |
Переопределено для повышения производительности. |
void |
firePropertyChange |
Переопределено для повышения производительности. |
void |
firePropertyChange |
Переопределено для повышения производительности. |
protected void |
firePropertyChange |
Переопределено для повышения производительности. |
Color |
getBackgroundNonSelectionColor() |
Возвращает цвет фона, используемый для невыбранных узлов. |
Color |
getBackgroundSelectionColor() |
Возвращает цвет фона, используемый для выбранных узлов. |
Color |
getBorderSelectionColor() |
Возвращает цвет границы. |
Icon |
getClosedIcon() |
Возвращает значок, используемый для представления нелистовых узлов, которые не развернуты. |
Icon |
getDefaultClosedIcon() |
Возвращает значок по умолчанию для текущего внешнего вида, используемый для представления нелистовых узлов, которые не развернуты. |
Icon |
getDefaultLeafIcon() |
Возвращает значок по умолчанию для текущего внешнего вида, используемый для представления листовых узлов. |
Icon |
getDefaultOpenIcon() |
Возвращает значок по умолчанию для текущего внешнего вида, используемый для представления развернутых нелистовых узлов. |
Font |
getFont() |
Возвращает шрифт этого компонента. |
Icon |
getLeafIcon() |
Возвращает значок, используемый для представления листовых узлов. |
Icon |
getOpenIcon() |
Возвращает значок, используемый для представления развернутых нелистовых узлов. |
Dimension |
getPreferredSize() |
Переопределяет JComponent.getPreferredSize для возвращения немного большего значения предпочтительного размера. |
Color |
getTextNonSelectionColor() |
Возвращает цвет текста, используемый при отображении невыбранного узла. |
Color |
getTextSelectionColor() |
Возвращает цвет текста, используемый при отображении выбранного узла. |
Component |
getTreeCellRendererComponent |
Настраивает рендерер на основе переданных компонентов. |
void |
invalidate() |
Переопределено для повышения производительности. |
void |
paint |
Отображает значение. |
void |
repaint() |
Переопределено для повышения производительности. |
void |
repaint |
Переопределено для повышения производительности. |
void |
repaint |
Переопределено для повышения производительности. |
void |
revalidate() |
Переопределено для повышения производительности. |
void |
setBackground |
Подклассировано для сопоставления ColorUIResource с null. |
void |
setBackgroundNonSelectionColor |
Устанавливает цвет фона для невыбранных узлов. |
void |
setBackgroundSelectionColor |
Устанавливает цвет фона для выбранных узлов. |
void |
setBorderSelectionColor |
Устанавливает цвет границы. |
void |
setClosedIcon |
Устанавливает значок для представления нелистовых узлов, которые не развернуты. |
void |
setFont |
Подклассировано для сопоставления FontUIResource с null. |
void |
setLeafIcon |
Устанавливает значок для представления листовых узлов. |
void |
setOpenIcon |
Устанавливает значок для представления развернутых нелистовых узлов. |
void |
setTextNonSelectionColor |
Устанавливает цвет текста для невыбранного узла. |
void |
setTextSelectionColor |
Устанавливает цвет текста для выбранного узла. |
void |
updateUI() |
Сбрасывает свойство пользовательского интерфейса на значение из текущего внешнего вида. |
void |
validate() |
Переопределено для повышения производительности. |
Methods declared in class javax.swing.JLabel
checkHorizontalKey, checkVerticalKey, getAccessibleContext, getDisabledIcon, getDisplayedMnemonic, getDisplayedMnemonicIndex, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getLabelFor, getText, getUI, getUIClassID, getVerticalAlignment, getVerticalTextPosition, imageUpdate, paramString, setDisabledIcon, setDisplayedMnemonic, setDisplayedMnemonic, setDisplayedMnemonicIndex, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabelFor, setText, setUI, setVerticalAlignment, setVerticalTextPosition
Methods declared in class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
Methods declared in class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validateTree
Methods declared in class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
Подробное описание полей
selected
protected boolean selected
hasFocus
protected boolean hasFocus
closedIcon
protected transient Icon closedIcon
leafIcon
protected transient Icon leafIcon
openIcon
protected transient Icon openIcon
textSelectionColor
protected Color textSelectionColor
textNonSelectionColor
protected Color textNonSelectionColor
backgroundSelectionColor
protected Color backgroundSelectionColor
backgroundNonSelectionColor
protected Color backgroundNonSelectionColor
borderSelectionColor
protected Color borderSelectionColor
Подробное описание конструкторов
DefaultTreeCellRenderer
public DefaultTreeCellRenderer()
DefaultTreeCellRenderer. Иконки и цвет текста определяются из UIManager.Подробное описание методов
updateUI
getDefaultOpenIcon
public Icon getDefaultOpenIcon()
- Возвращает:
- стандартную иконку, для текущей темы, используемую для отображения раскрытых узлов, не являющихся листьями.
getDefaultClosedIcon
public Icon getDefaultClosedIcon()
- Возвращает:
- стандартную иконку, для текущей темы, используемую для отображения узлов, не являющихся листьями, и не раскрытых.
getDefaultLeafIcon
public Icon getDefaultLeafIcon()
- Возвращает:
- стандартную иконку, для текущей темы, используемую для отображения листовых узлов.
setOpenIcon
public void setOpenIcon(Icon newIcon)
- Параметры:
-
newIcon- иконка для отображения раскрытых узлов, не являющихся листьями
getOpenIcon
public Icon getOpenIcon()
- Возвращает:
- иконку для отображения раскрытых узлов, не являющихся листьями
setClosedIcon
public void setClosedIcon(Icon newIcon)
- Параметры:
-
newIcon- иконка для отображения нераскрытых узлов, не являющихся листьями
getClosedIcon
public Icon getClosedIcon()
- Возвращает:
- иконку для отображения узлов, не являющихся листьями, и не раскрытых
setLeafIcon
public void setLeafIcon(Icon newIcon)
- Параметры:
-
newIcon- иконка для отображения листовых узлов
getLeafIcon
public Icon getLeafIcon()
- Возвращает:
- иконку для отображения листовых узлов
setTextSelectionColor
public void setTextSelectionColor(Color newColor)
- Параметры:
-
newColor- цвет текста при выделении узла
getTextSelectionColor
public Color getTextSelectionColor()
- Возвращает:
- цвет текста при выделении узла
setTextNonSelectionColor
public void setTextNonSelectionColor(Color newColor)
- Параметры:
-
newColor- цвет текста при отсутствии выделения узла
getTextNonSelectionColor
public Color getTextNonSelectionColor()
- Возвращает:
- цвет текста при отсутствии выделения узла.
setBackgroundSelectionColor
public void setBackgroundSelectionColor(Color newColor)
- Параметры:
-
newColor- цвет фона при выделении узла
getBackgroundSelectionColor
public Color getBackgroundSelectionColor()
- Возвращает:
- цвет фона при выделении узла
setBackgroundNonSelectionColor
public void setBackgroundNonSelectionColor(Color newColor)
- Параметры:
-
newColor- цвет фона при отсутствии выделения узла
getBackgroundNonSelectionColor
public Color getBackgroundNonSelectionColor()
- Возвращает:
- цвет фона при отсутствии выделения узла.
setBorderSelectionColor
public void setBorderSelectionColor(Color newColor)
- Параметры:
-
newColor- цвет границы
getBorderSelectionColor
public Color getBorderSelectionColor()
- Возвращает:
- цвет границы
setFont
public void setFont(Font font)
FontUIResource с null. Если font равно null, или это FontUIResource, это приводит к отображению шрифта JTree. С другой стороны, если font не null и не FontUIResource, шрифт становится font.- Overrides:
-
setFontв классеJComponent - Параметры:
-
font- нужныйFontдля этого компонента - См. также:
getFont
public Font getFont()
- Определяется в:
-
getFontв интерфейсеMenuContainer - Переопределяет:
-
getFontв классеComponent - Возвращает:
- шрифт этого компонента; если для этого компонента шрифт не был задан, возвращается шрифт его родителя
- См. также:
setBackground
public void setBackground(Color color)
ColorUIResource с null. Если color равно null или является ColorUIResource, это приводит к отображению цвета фона JTree. В противном случае, если color не null и не является ColorUIResource, фон становится color.- Переопределяет:
-
setBackgroundв классеJComponent - Параметры:
-
color- требуемый цвет фонаColor - См. также:
getTreeCellRendererComponent
public Component getTreeCellRendererComponent(JTree tree, Object value, boolean sel, boolean expanded, boolean leaf, int row, boolean hasFocus)
convertValueToText, что в конечном счёте вызывает toString для value. Цвет переднего плана устанавливается на основе выделения, а иконка устанавливается на основе параметров leaf и expanded.- Определяется в:
-
getTreeCellRendererComponentв интерфейсеTreeCellRenderer - Параметры:
-
tree- компонент, для которого настраивается рендерер -
value- значение, подлежащее рендерингу -
sel- выделен ли узел -
expanded- раскрыт ли узел -
leaf- является ли узел лидирующим -
row- индекс строки -
hasFocus- имеет ли узел фокус - Возвращает:
Component, используемый рендерером для отображения значения
paint
public void paint(Graphics g)
- Переопределяет:
-
paintв классеJComponent - Параметры:
-
g- контекстGraphicsдля рисования - См. также:
getPreferredSize
public Dimension getPreferredSize()
JComponent.getPreferredSize для возвращения слегка более широкого значения предпочтительного размера.- Переопределяет:
-
getPreferredSizeв классеJComponent - Возвращает:
- значение свойства
preferredSize - См. также:
validate
public void validate()
invalidate
public void invalidate()
- Переопределяет:
-
invalidateв классеContainer - С:
- 1.5
- См. также:
revalidate
public void revalidate()
- Переопределяет:
-
revalidateв классеJComponent - См. также:
repaint
public void repaint(long tm, int x, int y, int width, int height)
- Переопределяет:
-
repaintв классеJComponent - Параметры:
-
tm- этот параметр не используется -
x- x значение повреждённой области -
y- y значение повреждённой области -
width- ширина повреждённой области -
height- высота повреждённой области - См. также:
repaint
public void repaint(Rectangle r)
- Переопределяет:
-
repaintв классеJComponent - Параметры:
-
r-Rectangle, содержащий повреждённую область - См. также:
repaint
public void repaint()
firePropertyChange
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
- Переопределяет:
-
firePropertyChangeв классеComponent - Параметры:
-
propertyName- свойство, значение которого изменилось -
oldValue- предыдущее значение свойства -
newValue- новое значение свойства
firePropertyChange
public void firePropertyChange(String propertyName, byte oldValue, byte newValue)
- Переопределяет:
-
firePropertyChangeв классеComponent - Параметры:
-
propertyName- программное имя изменённого свойства -
oldValue- старое значение свойства (в виде байта) -
newValue- новое значение свойства (в виде байта) - См. также:
firePropertyChange
public void firePropertyChange(String propertyName, char oldValue, char newValue)
- Overrides:
-
firePropertyChangeв классеComponent - Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (как char) -
newValue- новое значение свойства (как char) - См. также:
firePropertyChange
public void firePropertyChange(String propertyName, short oldValue, short newValue)
- Overrides:
-
firePropertyChangeв классеComponent - Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (как short) -
newValue- новое значение свойства (как short) - См. также:
firePropertyChange
public void firePropertyChange(String propertyName, int oldValue, int newValue)
- Overrides:
-
firePropertyChangeв классеJComponent - Параметры:
-
propertyName- свойство, значение которого было изменено -
oldValue- предыдущее значение свойства -
newValue- новое значение свойства
firePropertyChange
public void firePropertyChange(String propertyName, long oldValue, long newValue)
- Overrides:
-
firePropertyChangeв классеComponent - Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (как long) -
newValue- новое значение свойства (как long) - См. также:
firePropertyChange
public void firePropertyChange(String propertyName, float oldValue, float newValue)
- Overrides:
-
firePropertyChangeв классеComponent - Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (как float) -
newValue- новое значение свойства (как float) - См. также:
firePropertyChange
public void firePropertyChange(String propertyName, double oldValue, double newValue)
- Overrides:
-
firePropertyChangeв классеComponent - Параметры:
-
propertyName- программистское имя свойства, которое было изменено -
oldValue- старое значение свойства (как double) -
newValue- новое значение свойства (как double) - См. также:
firePropertyChange
public void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
- Overrides:
-
firePropertyChangeв классеJComponent - Параметры:
-
propertyName- свойство, значение которого было изменено -
oldValue- предыдущее значение свойства -
newValue- новое значение свойства
© 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/tree/DefaultTreeCellRenderer.html