如何在JavaFX全局场景检测onMouseMoved？TabPane无响应解惑

为什么TabPane区域的鼠标移动无法触发根AnchorPane的事件？ #

JavaFX中MouseMoved属于直接事件（Direct Event），这类事件只会发送给鼠标当前指向的目标节点，不会像点击事件那样向上冒泡到父节点。TabPane及其内部的Tab内容区域都是独立的节点，当鼠标在这些区域移动时，事件会被TabPane或其子节点接收，根AnchorPane作为父节点无法感知到该事件。

实现全场景鼠标/键盘操作检测的方法 #

要捕获整个场景内的所有鼠标移动和键盘操作，最简洁的方式是给Scene添加事件过滤器。事件过滤器会在事件到达目标节点之前触发，不受事件是否被消费的影响，完美覆盖所有节点区域。

修改后的代码示例 #

1. 更新MoveTest.java

public class MoveTest extends Application {
    private static final long INACTIVE_TIMEOUT = 15 * 60 * 1000; // 15分钟对应的毫秒数
    private Timer idleTimer;

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

    @Override
    public void start(Stage primaryStage) throws Exception {
        loadIhm(primaryStage);  
    }

    void loadIhm(Stage stage) throws URISyntaxException {
        URL location = MouseTestCtrl.class.getResource("/application/mouseTest.fxml");
        FXMLLoader loader = new FXMLLoader(location);

        try {   
            AnchorPane root = loader.load();    
            Scene scene = new Scene(root);
            
            // 初始化闲置计时器
            resetIdleTimer();

            // 给场景添加鼠标移动事件过滤器，捕获全场景的鼠标移动
            scene.addEventFilter(MouseEvent.MOUSE_MOVED, event -> {
                resetIdleTimer();
                System.out.println("moving");
            });

            // 监听所有键盘事件，覆盖纯键盘操作的闲置检测
            scene.addEventFilter(KeyEvent.ANY, event -> resetIdleTimer());

            stage.setScene(scene);
            stage.show();
        } catch (IOException e) {
            throw new RuntimeException("FXML加载异常: mouseTest.fxml");
        }
    }

    // 重置闲置计时器
    private void resetIdleTimer() {
        if (idleTimer != null) {
            idleTimer.cancel();
        }
        idleTimer = new Timer();
        idleTimer.schedule(new TimerTask() {
            @Override
            public void run() {
                // 在JavaFX主线程中执行关闭操作
                Platform.runLater(() -> Platform.exit());
            }
        }, INACTIVE_TIMEOUT);
    }
}

2. 清理冗余代码

如果不需要在控制器中单独处理移动事件，可直接删除MouseTestCtrl中的moveDetected方法，同时删除FXML文件中根AnchorPane的onMouseMoved="#moveDetected"属性。

关键说明 #

• 事件过滤器（addEventFilter）与普通事件监听器（addEventHandler）的区别：过滤器在事件传递到目标节点前触发，监听器仅在事件冒泡阶段触发。对于MouseMoved这类不冒泡的事件，必须使用过滤器才能实现全场景捕获。
• 必须同时监听键盘事件，否则用户仅使用键盘操作时不会重置计时器，导致应用误关闭。
• 计时器任务中必须使用Platform.runLater，因为Timer线程不属于JavaFX主线程，无法直接执行UI相关操作或调用应用关闭方法。

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