Класс DefaultTreeCellRenderer

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JLabel
      - javax.swing.tree.DefaultTreeCellRenderer

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants, TreeCellRenderer

public class DefaultTreeCellRenderer
extends JLabel
implements TreeCellRenderer

Отображает элемент в дереве. DefaultTreeCellRenderer не является непрозрачным, и если вы не переопределяете метод paint, то не должны изменять этот параметр. Обратитесь к Инструкции по работе с деревьями в Java Tutorial для примеров настройки отображения узлов с помощью этого класса.

Набор иконок и цветов, используемых 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.JLabel

labelFor

Поля, унаследованные от класса 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

Поля, унаследованные от интерфейса 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

Поля, унаследованные от интерфейса java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Конструкторы

Конструктор и описание
`DefaultTreeCellRenderer()` Создает `DefaultTreeCellRenderer`.

Методы

Модификатор и тип	Метод и описание
`void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)` Переопределено для повышения производительности.
`void`	`firePropertyChange(String propertyName, byte oldValue, byte newValue)` Переопределено для повышения производительности.
`void`	`firePropertyChange(String propertyName, char oldValue, char newValue)` Переопределено для повышения производительности.
`void`	`firePropertyChange(String propertyName, double oldValue, double newValue)` Переопределено для повышения производительности.
`void`	`firePropertyChange(String propertyName, float oldValue, float newValue)` Переопределено для повышения производительности.
`void`	`firePropertyChange(String propertyName, int oldValue, int newValue)` Переопределено для повышения производительности.
`void`	`firePropertyChange(String propertyName, long oldValue, long newValue)` Переопределено для повышения производительности.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)` Переопределено для повышения производительности.
`void`	`firePropertyChange(String propertyName, short oldValue, short newValue)` Переопределено для повышения производительности.
`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(JTree tree, Object value, boolean sel, boolean expanded, boolean leaf, int row, boolean hasFocus)` Настраивает рендерер на основе переданных компонентов.
`void`	`invalidate()` Переопределено для повышения производительности.
`void`	`paint(Graphics g)` Отображает значение.
`void`	`repaint()` Переопределено для повышения производительности.
`void`	`repaint(long tm, int x, int y, int width, int height)` Переопределено для повышения производительности.
`void`	`repaint(Rectangle r)` Переопределено для повышения производительности.
`void`	`revalidate()` Переопределено для повышения производительности.
`void`	`setBackground(Color color)` Подкласс для отображения `ColorUIResource` в виде null.
`void`	`setBackgroundNonSelectionColor(Color newColor)` Устанавливает цвет фона для невыбранных узлов.
`void`	`setBackgroundSelectionColor(Color newColor)` Устанавливает цвет фона для выбранных узлов.
`void`	`setBorderSelectionColor(Color newColor)` Устанавливает цвет границы.
`void`	`setClosedIcon(Icon newIcon)` Устанавливает значок для нелистовых узлов, которые не развернуты.
`void`	`setFont(Font font)` Подкласс для отображения `FontUIResource` в виде null.
`void`	`setLeafIcon(Icon newIcon)` Устанавливает значок для листовых узлов.
`void`	`setOpenIcon(Icon newIcon)` Устанавливает значок для развернутых нелистовых узлов.
`void`	`setTextNonSelectionColor(Color newColor)` Устанавливает цвет текста для невыбранных узлов.
`void`	`setTextSelectionColor(Color newColor)` Устанавливает цвет текста для выбранных узлов.
`void`	`updateUI()` Сбрасывает свойство пользовательского интерфейса до значения из текущего стиля.
`void`	`validate()` Переопределено для повышения производительности.

Методы, унаследованные от класса 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

Методы, унаследованные от класса 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

Методы, унаследованные от класса 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

Методы, унаследованные от класса 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, унаследованные от класса java.lang.Object

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

Поля

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

public void updateUI()

Сбрасывает свойство UI на значение из текущего стиля.

Overrides:: updateUI в классе JLabel
Since:: 1.7
See Also:: JComponent.updateUI()

getDefaultOpenIcon

public Icon getDefaultOpenIcon()

Возвращает стандартную иконку для текущего стиля, используемую для отображения нелистовых узлов, которые раскрыты.

getDefaultClosedIcon

public Icon getDefaultClosedIcon()

Возвращает стандартную иконку для текущего стиля, используемую для отображения нелистовых узлов, которые не раскрыты.

getDefaultLeafIcon

public Icon getDefaultLeafIcon()

Возвращает стандартную иконку для текущего стиля, используемую для отображения листовых узлов.

setOpenIcon

public void setOpenIcon(Icon newIcon)

Устанавливает иконку, используемую для отображения нелистовых узлов, которые раскрыты.

getOpenIcon

public Icon getOpenIcon()

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

setClosedIcon

public void setClosedIcon(Icon newIcon)

Устанавливает иконку, используемую для отображения нелистовых узлов, которые не раскрыты.

getClosedIcon

public Icon getClosedIcon()

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

setLeafIcon

public void setLeafIcon(Icon newIcon)

Устанавливает иконку, используемую для отображения листовых узлов.

getLeafIcon

public Icon getLeafIcon()

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

setTextSelectionColor

public void setTextSelectionColor(Color newColor)

Устанавливает цвет текста при выборе узла.

getTextSelectionColor

public Color getTextSelectionColor()

Возвращает цвет текста при выборе узла.

setTextNonSelectionColor

public void setTextNonSelectionColor(Color newColor)

Устанавливает цвет текста, когда узел не выбран.

getTextNonSelectionColor

public Color getTextNonSelectionColor()

Возвращает цвет текста, когда узел не выбран.

setBackgroundSelectionColor

public void setBackgroundSelectionColor(Color newColor)

Устанавливает цвет фона для выбранного узла.

getBackgroundSelectionColor

public Color getBackgroundSelectionColor()

Возвращает цвет фона для выбранного узла.

setBackgroundNonSelectionColor

public void setBackgroundNonSelectionColor(Color newColor)

Устанавливает цвет фона для узлов, которые не выбраны.

getBackgroundNonSelectionColor

public Color getBackgroundNonSelectionColor()

Возвращает цвет фона для узлов, которые не выбраны.

setBorderSelectionColor

public void setBorderSelectionColor(Color newColor)

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

getBorderSelectionColor

public Color getBorderSelectionColor()

Возвращает цвет границы.

setFont

public void setFont(Font font)

Переопределяет метод, чтобы отобразить FontUIResource как null. Если font равно null или является FontUIResource, шрифт отобразится как шрифт JTree. В противном случае, шрифт становится font.

Overrides:: setFont в классе JComponent
Parameters:: font - требуемый шрифт для данного компонента
See Also:: Component.getFont()

getFont

public Font getFont()

Получает шрифт этого компонента.

Specified by:: getFont в интерфейсе MenuContainer
Overrides:: getFont в классе Component
Returns:: шрифт этого компонента; если шрифт не задан, возвращается шрифт родителя
See Also:: Component.setFont(java.awt.Font)

setBackground

public void setBackground(Color color)

Переопределяет метод, чтобы отобразить ColorUIResource как null. Если color равно null или является ColorUIResource, цвет фона отобразится как цвет фона JTree. В противном случае, цвет фона становится color.

Overrides:: setBackground в классе JComponent
Parameters:: color - желаемый цвет фона
See Also:: Component.getBackground(), JComponent.setOpaque(boolean)

getTreeCellRendererComponent

public Component getTreeCellRendererComponent(JTree tree,
                                              Object value,
                                              boolean sel,
                                              boolean expanded,
                                              boolean leaf,
                                              int row,
                                              boolean hasFocus)

Настраивает рендерер на основе переданных компонентов. Значение устанавливается из сообщения в дерево с convertValueToText, что в конечном итоге вызывает toString в value. Цвет шрифта устанавливается в зависимости от выбора, а иконка — в зависимости от параметров leaf и expanded.

Specified by:: getTreeCellRendererComponent в интерфейсе TreeCellRenderer
Returns:: значение, которое рендерер использует для отрисовки значения

paint

public void paint(Graphics g)

Отрисовывает значение. Фон заполняется в зависимости от выбранного значения.

Overrides:: paint в классе JComponent
Parameters:: g - контекст отрисовки
See Also:: JComponent.paintComponent(java.awt.Graphics), JComponent.paintBorder(java.awt.Graphics), JComponent.paintChildren(java.awt.Graphics), JComponent.getComponentGraphics(java.awt.Graphics), JComponent.repaint(long, int, int, int, int)

getPreferredSize

public Dimension getPreferredSize()

Переопределяет JComponent.getPreferredSize для возвращения немного более широкого значения предпочтительного размера.

Overrides:: getPreferredSize в классе JComponent
Returns:: значение свойства preferredSize
See Also:: JComponent.setPreferredSize(java.awt.Dimension), ComponentUI