如何让Java Swing的JTree仅在鼠标悬停节点图标时显示工具提示

要实现仅鼠标悬停在节点图标上时才显示提示框，不能直接在渲染器中全局设置setToolTipText，因为JTree默认会将渲染器返回的组件提示作为整行的提示。可以通过重写JTree的getToolTipText方法判断鼠标位置来实现，具体步骤如下：

• 自定义DefaultTreeCellRenderer时仅设置自定义图标，不调用setToolTipText方法设置全局提示。
• 自定义JTree子类，重写getToolTipText(MouseEvent event)方法，在方法内判断鼠标是否落在当前节点的图标区域内，再决定是否返回提示文本。
• 可将不同节点对应图标的提示文本存储在自定义TreeNode的属性中，或单独维护映射关系，按需读取返回。

核心代码示例 #

import javax.swing.*;
import javax.swing.tree.DefaultTreeCellRenderer;
import javax.swing.tree.TreePath;
import java.awt.*;
import java.awt.event.MouseEvent;

public class IconOnlyTooltipTree extends JTree {
    // 自定义节点图标示例，可根据节点类型替换为不同图标
    private final Icon customNodeIcon = new ImageIcon("你的自定义图标路径.png");

    private final DefaultTreeCellRenderer customRenderer = new DefaultTreeCellRenderer() {
        @Override
        public Component getTreeCellRendererComponent(JTree tree, Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus) {
            super.getTreeCellRendererComponent(tree, value, selected, expanded, leaf, row, hasFocus);
            // 仅设置自定义图标，不在这里设置全局tooltip
            setIcon(customNodeIcon);
            return this;
        }
    };

    public IconOnlyTooltipTree() {
        setCellRenderer(customRenderer);
        // 启用JTree的tooltip支持
        ToolTipManager.sharedInstance().registerComponent(this);
    }

    @Override
    public String getToolTipText(MouseEvent e) {
        Point mousePoint = e.getPoint();
        // 获取鼠标当前命中的行
        int hitRow = getRowForLocation(mousePoint.x, mousePoint.y);
        if (hitRow < 0) {
            return null;
        }
        TreePath hitPath = getPathForRow(hitRow);
        if (hitPath == null) {
            return null;
        }
        // 获取当前行的渲染边界
        Rectangle rowBound = getRowBounds(hitRow);
        // 自定义图标区域计算：如果需要排除前面的展开/折叠控制图标，可额外加上getLeftChildIndent() + getRightChildIndent()作为x偏移
        int iconStartX = rowBound.x;
        int iconEndX = iconStartX + customNodeIcon.getIconWidth();
        int iconStartY = rowBound.y;
        int iconEndY = iconStartY + customNodeIcon.getIconHeight();

        // 判断鼠标是否落在自定义图标区域内
        if (mousePoint.x >= iconStartX && mousePoint.x <= iconEndX
                && mousePoint.y >= iconStartY && mousePoint.y <= iconEndY) {
            // 可根据当前节点hitPath.getLastPathComponent()返回对应自定义提示
            return "当前节点图标的提示文本";
        }
        // 非图标区域返回null，不显示提示
        return null;
    }
}

注意：如果不同节点使用不同大小的图标，需要对应调整图标宽高的取值逻辑，从对应节点的配置中获取对应图标参数即可。

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