如何为JavaFX应用添加全局鼠标事件监听器？

要实现监听整个JavaFX应用的所有鼠标事件（覆盖所有Stage、Scene和Node），可以通过给每个Window注册全局事件过滤器的方式实现，具体如下：

核心思路 #

JavaFX中所有窗口（Stage是Window的子类）都支持添加事件过滤器，这类过滤器会在事件传递到目标节点之前触发。通过给应用内所有Window注册MouseEvent.ANY类型的过滤器，就能捕获所有鼠标事件；同时监听应用窗口列表的变化，确保动态创建的新窗口也能被自动监听。

代码实现 #

import javafx.application.Application;
import javafx.collections.ListChangeListener;
import javafx.scene.input.MouseEvent;
import javafx.stage.Stage;
import javafx.stage.Window;

public class GlobalMouseListenerApp extends Application {

    @Override
    public void start(Stage primaryStage) {
        // 为现有窗口注册鼠标事件过滤器
        registerMouseFilterForAllWindows();
        
        // 监听窗口列表变化，为新创建的窗口自动注册过滤器
        Application.getWindows().addListener((ListChangeListener<Window>) change -> {
            while (change.next()) {
                if (change.wasAdded()) {
                    change.getAddedSubList().forEach(this::addMouseEventFilter);
                }
            }
        });
        
        // 初始化并显示主窗口
        primaryStage.setTitle("Global Mouse Listener Demo");
        primaryStage.show();
    }

    private void registerMouseFilterForAllWindows() {
        Application.getWindows().forEach(this::addMouseEventFilter);
    }

    private void addMouseEventFilter(Window window) {
        window.addEventFilter(MouseEvent.ANY, event -> {
            // 这里处理全局鼠标事件，示例为打印事件信息
            System.out.printf("全局鼠标事件: %s | 来源节点: %s%n", 
                    event.getEventType().getName(), event.getSource().getClass().getSimpleName());
            
            // 若需让事件继续传递到目标节点，不要调用event.consume()
            // event.consume();
        });
    }

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

关键注意事项 #

• 事件传递控制：如果不需要阻止事件到达目标节点，不要调用event.consume()，否则目标Node将无法收到该事件。
• 线程安全：所有JavaFX UI操作必须在JavaFX应用线程执行，示例中通过Application.getWindows()的监听器确保注册操作在正确线程执行。
• 覆盖动态窗口：通过监听Application.getWindows()的列表变化，能自动捕获后续动态创建的Stage（如弹窗、子窗口），避免遗漏。
• 事件类型筛选：使用MouseEvent.ANY可以监听所有鼠标相关事件（点击、移动、滚轮等），若只需特定类型，可替换为MouseEvent.MOUSE_CLICKED、MouseEvent.MOUSE_MOVED等具体事件类型。

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