Electron 中使用 C++ 模块监听鼠标中间按钮事件

本文介绍如何在 Electron 中使用 C++ 模块来监听鼠标中间按钮事件，并提供跨平台解决方案，以及 Node.js 调用示例。

首先，我们需要在 C++ 中监听鼠标中间按钮按下的事件。对于不同的系统，我们需要使用不同的 API。在 Windows 下，我们可以使用 Windows API 的SetWindowsHookEx函数；在 Linux 下，我们可以使用 X11 库；在 Mac 下，我们可以使用 Core Graphics 框架。

为了方便起见，我们可以使用跨平台的库来实现这个功能。这里我选择了nbind，一个非常方便的跨平台 C++ 绑定库。

首先，我们需要安装nbind：

npm install nbind --save

然后，我们在 C++ 代码中使用nbind绑定事件：

#include <nbind/nbind.h>
#include <iostream>

// Windows
#ifdef _WIN32
#include <windows.h>
HHOOK hook = NULL;
LRESULT CALLBACK MouseProc(int nCode, WPARAM wParam, LPARAM lParam) {
    if (nCode >= 0 && wParam == WM_MBUTTONDOWN) {
        // Call the registered callback functions
        // ...
    }
    return CallNextHookEx(hook, nCode, wParam, lParam);
}
#endif

// Linux
#ifdef __linux__
#include <X11/Xlib.h>
#include <X11/Xutil.h>
#include <X11/extensions/XInput.h>
Display* display;
Window root;
int device_id;
void handle_event(XEvent *event) {
    if (event->type == ButtonPress && event->xbutton.button == Button2) {
        // Call the registered callback functions
        // ...
    }
}
#endif

// Mac
#ifdef __APPLE__
#include <CoreGraphics/CoreGraphics.h>
CGEventRef eventCallback(CGEventTapProxy proxy, CGEventType type, CGEventRef event, void *refcon) {
    if (type == kCGEventOtherMouseDown && CGEventGetIntegerValueField(event, kCGMouseEventButtonNumber) == 2) {
        // Call the registered callback functions
        // ...
    }
    return event;
}
CFMachPortRef eventTap;
#endif

void addMiddleMouseClickListener(nbind::cbFunction& callback) {
    // TODO: Register the callback function
#ifdef _WIN32
    hook = SetWindowsHookEx(WH_MOUSE_LL, MouseProc, NULL, 0);
#endif
#ifdef __linux__
    display = XOpenDisplay(NULL);
    root = DefaultRootWindow(display);
    XDevice* device = NULL;
    int ndevices;
    XDeviceInfoPtr devices = XListInputDevices(display, &ndevices);
    for (int i = 0; i < ndevices; i++) {
        if (devices[i].id != XIAllMasterDevices && (devices[i].use == IsXExtensionDevice || devices[i].use == IsXPointerDevice)) {
            device = XOpenDevice(display, devices[i].id);
            if (device) {
                XEventClass event_list[5];
                int n = 0;
                XDeviceButtonPress(device, device_id, event_list[n], n++);
                XDeviceButtonRelease(device, device_id, event_list[n], n++);
                XSelectExtensionEvent(display, root, event_list, n);
                XEventClass event_class;
                while (true) {
                    XNextEvent(display, (XEvent*)&event_class);
                    if (event_class == event_list[0]) {
                        XDeviceButtonEvent* event = (XDeviceButtonEvent*)&event_class;
                        if (event->button == Button2) {
                            // Call the registered callback functions
                            // ...
                        }
                    }
                }
            }
        }
    }
#endif
#ifdef __APPLE__
    eventTap = CGEventTapCreate(kCGSessionEventTap, kCGHeadInsertEventTap, kCGEventTapOptionListenOnly, CGEventMaskBit(kCGEventOtherMouseDown), eventCallback, NULL);
    CFRunLoopSourceRef loopSource = CFMachPortCreateRunLoopSource(kCFAllocatorDefault, eventTap, 0);
    CFRunLoopAddSource(CFRunLoopGetCurrent(), loopSource, kCFRunLoopCommonModes);
    CGEventTapEnable(eventTap, true);
#endif
}

void removeMiddleMouseClickListener(nbind::cbFunction& callback) {
    // TODO: Remove the callback function
#ifdef _WIN32
    UnhookWindowsHookEx(hook);
#endif
#ifdef __linux__
    XCloseDisplay(display);
#endif
#ifdef __APPLE__
    CFMachPortInvalidate(eventTap);
    CFRelease(eventTap);
#endif
}

NBIND_GLOBAL() {
    function(addMiddleMouseClickListener);
    function(removeMiddleMouseClickListener);
}

在 Windows 上，我们使用SetWindowsHookEx函数来设置一个全局的鼠标钩子。当鼠标中间按钮按下时，MouseProc函数将被调用。在 Linux 上，我们使用 X11 库来监听鼠标事件。当鼠标中间按钮按下时，handle_event函数将被调用。在 Mac 上，我们使用 Core Graphics 框架来监听鼠标事件。当鼠标中间按钮按下时，eventCallback函数将被调用。

在addMiddleMouseClickListener函数中，我们需要将传入的回调函数注册到系统的事件监听器中。在 Windows 上，我们使用SetWindowsHookEx函数注册一个全局的鼠标钩子；在 Linux 上，我们使用 X11 库注册一个全局的事件监听器；在 Mac 上，我们使用 Core Graphics 框架注册一个全局的事件监听器。

在removeMiddleMouseClickListener函数中，我们需要将传入的回调函数从系统的事件监听器中移除。在 Windows 上，我们使用UnhookWindowsHookEx函数移除鼠标钩子；在 Linux 上，我们关闭 X11 的连接；在 Mac 上，我们使事件监听器失效并释放它。

最后，我们使用NBIND_GLOBAL()宏将addMiddleMouseClickListener和removeMiddleMouseClickListener函数导出为全局函数，以便 Node.js 可以调用它们。

接下来，我们可以编写一个简单的 Node.js 脚本来测试这个 C++ 模块：

const addon = require('bindings')('addon');

addon.addMiddleMouseClickListener(() => {
  console.log('Middle mouse button clicked');
});

setTimeout(() => {
  addon.removeMiddleMouseClickListener();
}, 5000);

这个脚本注册一个回调函数来监听鼠标中间按钮的点击事件。在 5 秒后，它将移除这个回调函数。当我们运行这个脚本时，我们应该能够看到它输出Middle mouse button clicked。

注意：以上代码示例仅供参考，实际使用时需要根据具体情况进行调整。例如，您可能需要将回调函数的调用封装到一个异步任务中，以避免阻塞主线程。此外，您还需要将 C++ 模块编译成 Node.js 可以加载的共享库。

希望本文能够帮助您了解如何在 Electron 中使用 C++ 模块来监听鼠标中间按钮事件。如果您有任何问题，请随时提问。