如何修改javax.swing.TreeCellRenderer实现树单元格文本描边？

嘿，这个需求我之前做过类似的！要给Swing树的单元格文本加描边，核心就是自定义TreeCellRenderer，替换掉默认的文本绘制逻辑，用Graphics2D的描边能力来实现。下面给你详细讲怎么搞：

最省心的方式是继承默认的DefaultTreeCellRenderer——它已经帮我们搞定了图标、选中状态、背景这些基础渲染逻辑，我们只需要重写文本绘制的部分就行。

步骤1：编写自定义渲染器类 #

我们要重写paintComponent方法，在父类完成基础绘制后，叠加描边文本的效果。这里用TextLayout来实现描边，比直接用drawString要灵活得多：

import javax.swing.*;
import javax.swing.tree.DefaultTreeCellRenderer;
import java.awt.*;
import java.awt.font.TextLayout;
import java.awt.geom.AffineTransform;

public class StrokedTreeCellRenderer extends DefaultTreeCellRenderer {
    // 可配置的描边属性
    private Stroke textStroke = new BasicStroke(2f);
    private Color strokeColor = Color.BLACK;

    @Override
    protected void paintComponent(Graphics g) {
        // 先让父类完成背景、图标这些基础绘制
        super.paintComponent(g);
        Graphics2D g2d = (Graphics2D) g.create();
        
        String text = getText();
        if (text == null || text.isBlank()) {
            g2d.dispose();
            return;
        }

        // 开启抗锯齿，让描边更平滑
        g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);

        // 计算文本的绘制坐标（和默认渲染器的文本位置对齐）
        Icon icon = getIcon();
        int textX = icon.getIconWidth() + getIconTextGap();
        FontMetrics metrics = g2d.getFontMetrics(getFont());
        int textY = getHeight() / 2 + metrics.getAscent() / 2;

        // 第一步：绘制文本描边
        g2d.setColor(strokeColor);
        g2d.setStroke(textStroke);
        TextLayout textLayout = new TextLayout(text, getFont(), g2d.getFontRenderContext());
        textLayout.draw(g2d, textX, textY, new AffineTransform());

        // 第二步：绘制原文本，覆盖在描边上
        g2d.setColor(isSelected() ? getTextSelectionColor() : getTextNonSelectionColor());
        textLayout.draw(g2d, textX, textY, new AffineTransform());

        // 记得释放Graphics资源
        g2d.dispose();
    }

    // 对外提供修改描边属性的方法
    public void setTextStroke(Stroke stroke) {
        this.textStroke = stroke;
    }

    public void setStrokeColor(Color color) {
        this.strokeColor = color;
    }
}

步骤2：把渲染器应用到JTree #

创建好渲染器后，直接设置给你的JTree就行，还能自定义描边的颜色和宽度：

JTree tree = new JTree();
StrokedTreeCellRenderer renderer = new StrokedTreeCellRenderer();
// 比如给文本加白色粗描边
renderer.setStrokeColor(Color.WHITE);
renderer.setTextStroke(new BasicStroke(3f));
tree.setCellRenderer(renderer);

关键细节提醒 #

• 图层顺序很重要：必须先画描边，再画原文本，这样文本才会覆盖在描边上，呈现出“外描边”的效果。
• 兼容选中状态：要区分选中/非选中时的文本颜色，保持和原生Swing树的交互体验一致。
• 资源释放：用g.create()创建的Graphics2D对象一定要调用dispose()，避免内存泄漏。
• 精准坐标计算：如果你的树有自定义图标或者布局，可能需要参考DefaultTreeCellRenderer源码里的文本位置计算逻辑，确保文本对齐准确。

内容的提问来源于stack exchange，提问作者Ivajlo Iliev