JavaFX如何使Tooltip固定显示在节点的右下角？

问题说明 #

• 想要Tooltip始终固定在节点的右下角，不管鼠标在节点的哪个位置
• 试了各种方法都没法覆盖默认行为，Tooltip总是跟着鼠标位置跑

最小复现代码 #

import javafx.application.Application;
import javafx.geometry.Point2D;
import javafx.scene.Scene;
import javafx.scene.control.Label;
import javafx.scene.control.Tooltip;
import javafx.scene.layout.AnchorPane;
import javafx.stage.Stage;
import javafx.util.Duration;

public class HelloApplication extends Application {

    @Override
    public void start(Stage stage) {
        Label label = new Label("TEST\nTEST\nTEST");
        label.setStyle("-fx-background-color: green;");

        Tooltip tooltip = new Tooltip("TOOLTIP");
        tooltip.setShowDelay(Duration.seconds(0.5));
        label.setTooltip(tooltip);

        Scene scene = new Scene(new AnchorPane(label));
        stage.setScene(scene);
        
        stage.show();

        Point2D p = label.localToScene(0.0, 0.0);
        label.getTooltip().show(label,
                p.getX() + label.getScene().getX() + label.getScene().getWindow().getX(),
                p.getY() + label.getScene().getY() + label.getScene().getWindow().getY());
    }

    public static void main(String[] args) {
        launch();
    }
}

效果对比 #

• 预期效果：
• 实际效果：

解决思路 #

默认的Tooltip是由TooltipBehavior内部类控制的，只要调用了setTooltip()，它就会绑定鼠标移动事件，自动重新计算显示位置——所以你手动调用的show()很快就会被覆盖。要实现固定位置，必须绕开默认的绑定逻辑，自己手动控制Tooltip的显示和位置。

可行方案 #

方案1：手动绑定鼠标事件控制Tooltip #

直接放弃setTooltip()，通过鼠标进入/移出事件手动控制Tooltip的显示、隐藏，并指定固定位置：

import javafx.application.Application;
import javafx.geometry.Bounds;
import javafx.scene.Scene;
import javafx.scene.control.Label;
import javafx.scene.control.Tooltip;
import javafx.scene.layout.AnchorPane;
import javafx.stage.Stage;
import javafx.util.Duration;
import javafx.animation.PauseTransition;

public class HelloApplication extends Application {

    @Override
    public void start(Stage stage) {
        Label label = new Label("TEST\nTEST\nTEST");
        label.setStyle("-fx-background-color: green;");

        Tooltip tooltip = new Tooltip("TOOLTIP");
        // 用PauseTransition实现延迟显示，替代默认的showDelay
        PauseTransition showDelay = new PauseTransition(Duration.seconds(0.5));
        showDelay.setOnFinished(e -> {
            // 获取节点在屏幕上的绝对边界
            Bounds screenBounds = label.localToScreen(label.getBoundsInLocal());
            // 把Tooltip显示在节点右下角
            tooltip.show(label, screenBounds.getMaxX(), screenBounds.getMaxY());
        });

        // 鼠标进入时启动延迟
        label.setOnMouseEntered(e -> showDelay.playFromStart());
        // 鼠标移出时取消延迟并隐藏Tooltip
        label.setOnMouseExited(e -> {
            showDelay.stop();
            tooltip.hide();
        });

        Scene scene = new Scene(new AnchorPane(label), 200, 200);
        stage.setScene(scene);
        stage.show();
    }

    public static void main(String[] args) {
        launch();
    }
}

代码解释 #

• localToScreen(label.getBoundsInLocal())：直接拿到节点在屏幕上的位置边界，不用手动累加窗口、场景的偏移量，计算更准确
• 用PauseTransition实现延迟显示，和默认的showDelay效果一致，但完全由我们控制
• 鼠标移出时同时停止延迟和隐藏Tooltip，避免鼠标快速移入移出时Tooltip误显示

方案2：自定义Tooltip的位置计算逻辑（进阶） #

如果你不想放弃setTooltip()的其他特性，可以通过反射修改TooltipBehavior的位置计算逻辑，但这种方法依赖JavaFX内部实现，版本更新可能失效，不推荐优先使用。

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