如何为java.awt.Panel添加提示框？是否需用鼠标事件？

嘿，这个问题我之前折腾过好一会儿！AWT的Panel确实不像Swing里的组件那样自带setToolTipText()方法，所以得手动借助鼠标事件来实现自定义的提示框。下面给你两种实用的实现方式，你可以根据自己的项目环境选：

如果你的项目必须完全基于AWT，那可以自己写一个轻量级的窗口作为Tooltip，通过鼠标事件控制它的显示和隐藏。

首先创建一个专门的Tooltip窗口类：

import java.awt.*;
import java.awt.event.*;

public class AWTTooltip extends Window {
    private String tipText;

    public AWTTooltip(Frame owner) {
        super(owner);
        setLayout(new BorderLayout());
        // 自定义Tooltip的样式，你可以根据需求调整
        setBackground(new Color(255, 255, 204));
        add(new Label() {
            @Override
            public void paint(Graphics g) {
                // 绘制提示文本，位置稍微偏移避免贴边
                g.drawString(tipText, 6, 16);
            }
        });
        // 去掉窗口边框，让它看起来像标准Tooltip
        setUndecorated(true);
    }

    public void setTipText(String text) {
        this.tipText = text;
        // 根据文本长度自动调整窗口大小
        FontMetrics fm = getFontMetrics(getFont());
        int width = fm.stringWidth(tipText) + 12;
        int height = fm.getHeight() + 8;
        setSize(width, height);
    }
}

然后给你的Panel添加鼠标监听逻辑：

public class PanelWithTooltip extends Panel {
    private AWTTooltip tooltip;
    private final String tooltipText;

    public PanelWithTooltip(Frame owner, String tipText) {
        this.tooltipText = tipText;
        tooltip = new AWTTooltip(owner);
        
        // 监听鼠标进入和移出事件
        addMouseListener(new MouseAdapter() {
            @Override
            public void mouseEntered(MouseEvent e) {
                // 鼠标进入时，把Tooltip显示在鼠标偏移一点的位置
                Point screenPoint = e.getLocationOnScreen();
                tooltip.setLocation(screenPoint.x + 10, screenPoint.y + 10);
                tooltip.setTipText(tooltipText);
                tooltip.setVisible(true);
            }

            @Override
            public void mouseExited(MouseEvent e) {
                // 鼠标移出时隐藏Tooltip
                tooltip.setVisible(false);
            }
        });

        // 可选：添加鼠标移动监听，让Tooltip跟着鼠标走
        addMouseMotionListener(new MouseMotionAdapter() {
            @Override
            public void mouseMoved(MouseEvent e) {
                Point screenPoint = e.getLocationOnScreen();
                tooltip.setLocation(screenPoint.x + 10, screenPoint.y + 10);
            }
        });
    }

    // 测试用的主方法
    public static void main(String[] args) {
        Frame frame = new Frame("AWT Panel Tooltip Demo");
        frame.setSize(400, 300);
        frame.setLayout(new FlowLayout());
        
        PanelWithTooltip panel = new PanelWithTooltip(frame, "这是我的AWT Panel提示框！");
        panel.setSize(200, 100);
        panel.setBackground(Color.CYAN);
        frame.add(panel);
        
        // 关闭窗口的逻辑
        frame.addWindowListener(new WindowAdapter() {
            @Override
            public void windowClosing(WindowEvent e) {
                System.exit(0);
            }
        });
        
        frame.setVisible(true);
    }
}

这个方法的核心就是用MouseListener来触发Tooltip的显示和隐藏，完全基于AWT API，没有依赖其他库。

如果你的项目允许混合使用AWT和Swing，那直接用Swing的JToolTip会更简单——毕竟Swing已经帮我们封装好了Tooltip的样式和逻辑，不用自己从头画。

代码示例如下：

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

public class PanelWithSwingTooltip extends Panel {
    private final JToolTip tooltip;

    public PanelWithSwingTooltip(String tipText) {
        tooltip = new JToolTip();
        tooltip.setTipText(tipText);
        tooltip.setOpaque(true); // 确保背景不透明
        
        addMouseListener(new MouseAdapter() {
            @Override
            public void mouseEntered(MouseEvent e) {
                // 获取Panel所在的顶级窗口，把Tooltip添加进去
                Window parentWindow = SwingUtilities.getWindowAncestor(PanelWithSwingTooltip.this);
                if (parentWindow != null) {
                    parentWindow.add(tooltip);
                    // 转换鼠标坐标为窗口内的位置
                    Point screenPoint = e.getLocationOnScreen();
                    Point windowLoc = parentWindow.getLocationOnScreen();
                    tooltip.setLocation(screenPoint.x - windowLoc.x + 10, screenPoint.y - windowLoc.y + 10);
                    tooltip.setVisible(true);
                    parentWindow.repaint();
                }
            }

            @Override
            public void mouseExited(MouseEvent e) {
                Window parentWindow = SwingUtilities.getWindowAncestor(PanelWithSwingTooltip.this);
                if (parentWindow != null && tooltip.isVisible()) {
                    parentWindow.remove(tooltip);
                    tooltip.setVisible(false);
                    parentWindow.repaint();
                }
            }
        });
    }

    // 测试主方法
    public static void main(String[] args) {
        Frame frame = new Frame("Panel + Swing Tooltip Demo");
        frame.setSize(400, 300);
        frame.setLayout(new FlowLayout());
        
        PanelWithSwingTooltip panel = new PanelWithSwingTooltip("用Swing实现的Panel提示框！");
        panel.setSize(200, 100);
        panel.setBackground(Color.PINK);
        frame.add(panel);
        
        frame.addWindowListener(new WindowAdapter() {
            @Override
            public void windowClosing(WindowEvent e) {
                System.exit(0);
            }
        });
        
        frame.setVisible(true);
    }
}

这种方法的优势很明显：不用自己处理文本绘制、窗口大小计算，Swing的JToolTip已经自带了标准的Tooltip样式，看起来更美观，代码量也更少。

不管用哪种方法，鼠标事件都是绕不开的——因为AWT的Panel本身没有内置Tooltip支持，必须通过监听鼠标的进入/移出动作来手动控制提示框的显示和隐藏。

如果是纯AWT环境，选方法一；如果可以引入Swing，方法二更高效省心。

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