如何用Graphics2D实现鼠标悬停时显示工具提示（JLabel顶点场景）

嘿，我看了你的代码和需求，发现几个关键问题导致鼠标交互和绘制不配合，下面一步步帮你搞定悬停显示工具提示的交互式图表需求：

先说说你代码里的核心问题 #

• 绘制时机错了：你在构造方法里直接用传入的Graphics2D画圆点，这不符合Swing的渲染机制。Swing组件的绘制应该交给paintComponent方法，由它的事件调度线程（EDT）触发，外部传的g2上下文可能随时失效，而且组件一重绘，你画的圆点就没了。
• 鼠标监听器里的绘制逻辑有问题：你在mouseMoved里直接操作传入的g2还调用dispose()，这会破坏全局的Graphics上下文，而且这种临时画的内容，组件一重绘就消失了，完全不是持久化的正确做法。
• 没用到JLabel自带的工具提示功能：JLabel本身就支持悬停显示工具提示，根本不需要自己手动画面板，简单配置就能实现需求。

修正后的完整代码 #

下面是调整后的代码，解决了上述问题，同时实现了悬停显示自定义文本工具提示的功能：

package GUI;

import java.awt.Color;
import java.awt.Dimension;
import java.awt.Graphics;
import java.awt.Graphics2D;
import javax.swing.JLabel;
import javax.swing.JToolTip;

@SuppressWarnings("serial")
public class Vertex extends JLabel {
    private int x;
    private int y;
    private int pointWidth;
    private String tooltipText; // 存储工具提示文本

    public Vertex(int x, int y, int pointWidth, String tooltipText) {
        this.x = x;
        this.y = y;
        this.pointWidth = pointWidth;
        this.tooltipText = tooltipText;

        // 设置组件位置和大小，确保鼠标能检测到悬停范围
        setLocation(x, y);
        setSize(new Dimension(pointWidth, pointWidth));
        setOpaque(false); // 保持透明，不遮挡背景内容

        // 直接启用JLabel自带的工具提示，自动处理悬停事件
        setToolTipText(tooltipText);
    }

    // 重写paintComponent，这是Swing组件正确的绘制入口
    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g); // 必须先调用父类方法，保证组件基础渲染
        Graphics2D g2 = (Graphics2D) g.create(); // 创建Graphics副本，避免污染原上下文

        // 绘制顶点圆点（用组件内部坐标，因为setLocation已经定位了组件）
        g2.setColor(Color.BLACK);
        g2.fillOval(0, 0, pointWidth, pointWidth);

        g2.dispose(); // 释放副本资源，这是Swing绘图的最佳实践
    }

    // 可选：自定义工具提示样式（比如背景色、字体）
    @Override
    public JToolTip createToolTip() {
        JToolTip tip = super.createToolTip();
        tip.setBackground(new Color(255, 255, 200)); // 浅黄色背景
        tip.setForeground(Color.DARK_GRAY); // 深灰色文本
        return tip;
    }

    // Getter和Setter方法
    public int getPointWidth() {
        return pointWidth;
    }

    public void setPointWidth(int pointWidth) {
        this.pointWidth = pointWidth;
        setSize(new Dimension(pointWidth, pointWidth));
        repaint(); // 修改大小后触发重绘，更新显示
    }

    public String getTooltipText() {
        return tooltipText;
    }

    public void setTooltipText(String tooltipText) {
        this.tooltipText = tooltipText;
        setToolTipText(tooltipText); // 更新工具提示内容
    }
}

关键改动说明 #

1. 正确的绘制逻辑：

   • 把绘制代码移到paintComponent方法里，这是Swing组件渲染的标准入口，每次组件需要更新显示（比如窗口 resize、状态变化）时，EDT都会自动调用它，这样你的圆点就不会莫名其妙消失了。
   • 用g.create()创建Graphics2D的副本，避免修改原上下文，用完后调用dispose()释放资源，这是Swing绘图的最佳实践，不会影响其他组件的渲染。
   • 绘制时用组件内部的(0,0)坐标，因为组件的位置已经通过setLocation设置好了，更符合Swing的坐标体系。

2. 工具提示的实现：

   • 直接用JLabel的setToolTipText()方法，Swing会自动监听鼠标悬停事件，当鼠标进入组件范围内时，自动显示工具提示——完全不需要你自己写鼠标监听器处理！
   • 如果想自定义工具提示的样式（比如背景色、字体），重写createToolTip()方法就行，示例里给了一个浅黄色背景的样式，你可以根据需求调整。

3. 鼠标交互的修复：

   • 确保组件的大小和位置正确设置，这样Swing才能准确检测到鼠标是否在顶点范围内。虽然JLabel默认是透明的，但只要设置了正确的大小，鼠标事件依然能被正常触发。

使用示例 #

在你的主窗口或面板中添加Vertex组件时，只需这样调用：

// 假设你有一个JPanel容器（注意如果用绝对布局，要先设置panel.setLayout(null)）
Vertex vertexA = new Vertex(50, 50, 10, "顶点A：坐标(50,50)");
yourPanel.add(vertexA);
yourPanel.repaint();

这样，当鼠标悬停在顶点圆点上时，就会显示你设置的工具提示文本啦！

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