重写JButton的paintComponent后，子JLabel无法正常绘制求助

问题描述 #

实现了继承自JButton的HoverButton类，内部包含子JLabel组件，重写paintComponent方法实现鼠标悬停时绘制半透明覆盖层，通过鼠标事件切换JLabel可见性。预期JLabel显示在半透明层上方，但重写paintComponent后该效果失效，未重写时功能正常。

核心问题分析 #

1. 绘制时机错误：Swing组件的绘制流程为paint() -> paintComponent() -> paintBorder() -> paintChildren()，若在paintComponent中绘制覆盖层，会先于子组件（JLabel）完成绘制；但原代码中手动销毁Graphics上下文，导致子组件绘制异常，反而出现覆盖层遮挡JLabel的情况。
2. 手动破坏绘制环境：调用g2d.dispose()销毁了Swing提供的Graphics对象，后续子组件的绘制逻辑无法正常执行。
3. 冗余图标绘制：手动调用getIcon().paintIcon，导致按钮图标被重复绘制，干扰正常显示。
4. 布局缺失：未给HoverButton设置布局管理器，JLabel的位置易出现错乱。

修复步骤 #

1. 调整覆盖层绘制时机：重写paint方法，在super.paint(g)之后绘制覆盖层，确保覆盖层显示在所有子组件上方。
2. 移除冗余操作：删除手动绘制图标的代码，super.paintComponent()会自动处理按钮图标。
3. 禁止手动释放Graphics：删除g2d.dispose()调用，由Swing负责管理绘制上下文。
4. 完善布局与事件触发：添加布局管理器让JLabel居中显示，鼠标事件中调用repaint()确保界面及时更新。

修改后的完整代码 #

import javax.swing.*;
import java.awt.*;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;

public class HoverButton extends JButton {

    private final JLabel label;
    private final String title;
    private boolean entered = false;

    public HoverButton(String title) {
        label = new JLabel();
        this.title = title;
        int startChar = title.indexOf(']') + 1;
        String regex = new StringBuilder("\\[[a-zA-Z0-9]+\\]")
                .append("| \\[[A-Za-z0-9]+ [A-Za-z0-9]+\\]")
                .append("| \\(decen\\)")
                .append("| \\(eng, decen\\)")
                .append("| \\(eng\\)")
                .append("|\\{.+\\}")
                .toString();
        String text = String.format("<html><p><b>%s</b></p></html>",
                title.substring(startChar).replaceAll(regex, "").trim());
        label.setText(text);
        label.setVisible(false);
        setLayout(new BorderLayout());
        add(label);
        addMouseListener(new MouseAdapter() {
            @Override
            public void mouseEntered(MouseEvent e) {
                entered = true;
                label.setVisible(true);
                repaint();
            }

            @Override
            public void mouseExited(MouseEvent e) {
                entered = false;
                label.setVisible(false);
                repaint();
            }
        });
    }

    public String getTitle() {
        return title;
    }

    @Override
    public void paintComponent(Graphics g) {
        super.paintComponent(g);
    }

    @Override
    public void paint(Graphics g) {
        super.paint(g);
        if (entered && g instanceof Graphics2D g2d) {
            int x = getInsets().left;
            int y = getInsets().top;
            int width = getWidth() - getInsets().left - getInsets().right;
            int height = getHeight() - getInsets().top - getInsets().bottom;
            g2d.setColor(new Color(0x88000000, true));
            g2d.fillRect(x, y, width, height);
        }
    }

    @Override
    public void setPreferredSize(Dimension d) {
        super.setPreferredSize(new Dimension(
                (int) (d.getWidth() + getInsets().right + getInsets().left),
                (int) (d.getHeight() + getInsets().top + getInsets().bottom)
        ));
        label.setMinimumSize(d);
    }
}

使用说明 #

调用时仍需保留以下代码确保按钮尺寸正确：

button.setIcon(icon);
button.setPreferredSize(new Dimension(icon.getWidth(), icon.getHeight()));

内容的提问来源于stack exchange，提问作者Greg Wright