在 Qt 中获取 MouseMove 事件

在编写 Qt 程序时，我希望在鼠标移动时（即使鼠标在另一个窗口上）能够调用 mouseMoveEvent(QMouseEvent* event) 方法。目前，在我的 mainwindow.cpp 文件中，我有如下代码：

void MainWindow::mouseMoveEvent(QMouseEvent* event) {
    qDebug() << QString::number(event->pos().x());
    qDebug() << QString::number(event->pos().y());
}

但这段代码似乎只在鼠标按下并拖动时才会被调用，而且仅限于在窗口上方。我尝试在 MainWindow 的构造函数中调用 setMouseTracking(true);，但这并没有产生任何不同的效果（只能在按住鼠标按钮时调用 mouseMoveEvent，无论鼠标位于何处）。那么，如何实现全局追踪鼠标位置呢？

解决方法

通过在应用程序上使用事件过滤器可以解决这个问题。

步骤一：定义并实现事件过滤器

在 MainWindow 类中定义并实现 eventFilter(QObject*, QEvent*) 方法。例如：

bool MainWindow::eventFilter(QObject *obj, QEvent *event)
{
    if (event->type() == QEvent::MouseMove)
    {
        QMouseEvent *mouseEvent = static_cast<QMouseEvent*>(event);
        statusBar()->showMessage(QString("Mouse move (%1,%2)").arg(mouseEvent->pos().x()).arg(mouseEvent->pos().y()));
    }
    return false;
}

步骤二：安装事件过滤器

在 MainWindow 的构造函数中安装事件过滤器。例如：

MainWindow::MainWindow(...)
{
    ...
    qApp->installEventFilter(this);
    ...
}

通过以上两步操作，我们可以在应用程序窗口内实现鼠标移动状态的持续更新。

拓展：全局鼠标事件捕捉

如果需要追踪应用程序窗口之外的鼠标移动，需要使用 QWidget::grabMouse() 方法。这会导致所有鼠标事件都被发送给捕获鼠标的窗口，从而阻止正常的窗口间交互。因此，可以在鼠标离开窗口时捕获鼠标（在 leaveEvent() 中调用 grabMouse()），并在鼠标进入窗口时释放鼠标（在 enterEvent() 中调用 releaseMouse()）。

然而，这种方法也可能带来一些负面影响。另一种替代方案是使用 QTimer 定时轮询鼠标位置，可以通过 QCursor::pos() 获取当前鼠标位置。

其他方案

如果只需要在应用程序的某特定部件内追踪鼠标移动，可以调用该部件的 setMouseTracking(true) 方法，例如：

this->viewport()->setMouseTracking(true);

然后重载 mouseMoveEvent 而不是创建和安装事件过滤器。

这种方法更为简单，不需要自定义事件过滤器，但需要将 setMouseTracking(true) 调用在正确的部件（如 viewport）上，而非主窗口本身。

总结

通过事件过滤器可以实现应用程序窗口内的鼠标移动状态更新，而通过捕捉鼠标或定时轮询的方法可以实现更广泛的鼠标位置追踪。根据具体需求选择合适的方法，以实现最佳效果。