QGraphicsRectItem子类无法接收mouseMoveEvent?

QGraphicsRectItem 子类无法接收 `mouseMoveEvent` 的原因和解决方法详解

当您创建 `QGraphicsRectItem` 的子类并尝试让它响应 `mouseMoveEvent` 时，却发现它没有被触发，这确实是一个常见的困惑。这通常不是因为 `QGraphicsRectItem` 本身不支持 `mouseMoveEvent`，而是由于其继承体系以及事件传播机制中的一些细节。

下面我们将详细探讨可能的原因和相应的解决方法。

为什么会出现这个问题？

核心原因在于 事件的接收者和事件的处理链条。Qt 的图形视图框架（Graphics View Framework）有一套精密的事件处理机制。

1. 鼠标事件的起源: 当鼠标在某个控件上移动时，操作系统会生成鼠标移动事件。
2. 事件的捕获和传递: 这些操作系统级别的事件会被 Qt 的事件分发系统捕获，并传递给最有可能处理它的控件。在图形视图框架中，这个过程会更加复杂一些。
3. `QGraphicsItem` 的事件处理: `QGraphicsItem` 是所有图形项的基类，它提供了虚函数来处理各种事件，包括 `mousePressEvent`, `mouseReleaseEvent`, `mouseMoveEvent` 等。
4. 事件的传播和过滤: 事件可能会在父项和子项之间传播。一个项可以通过重写事件处理函数来“消费”掉一个事件，阻止它继续向下传递给更底层的项，或者向上传递给父项。

导致 `QGraphicsRectItem` 子类无法接收 `mouseMoveEvent` 的最常见原因包括：

`setAcceptHoverEvents(true)` 未设置: 这是最普遍的原因。默认情况下，`QGraphicsItem` (包括 `QGraphicsRectItem`) 不接受悬停事件 (hover events)，而鼠标移动事件（当鼠标没有按下时）通常是作为悬停事件来处理的。即使鼠标按下移动，也需要先接受鼠标按下事件。为了让您的项响应鼠标移动，您必须明确地告诉它您关心这些事件。

事件被父项或场景拦截: 如果您的 `QGraphicsRectItem` 存在于一个场景中，并且场景中的其他项（特别是父项，如果您的项是另一个项的子项的话）也处理了鼠标移动事件，并且在处理函数中调用了 `event>ignore()` 或没有调用 `event>accept()`，那么您的项可能就接收不到这个事件了。

`mousePressEvent` 触发了拖动（Draging）: 如果您的 `QGraphicsRectItem` 子类在 `mousePressEvent` 中开始了一个拖动操作（例如通过 `QGraphicsScene::dragMoveEvent` 或其他拖动机制），并且该拖动操作拦截了后续的鼠标移动事件，那么您的 `mouseMoveEvent` 就不会被触发。

鼠标未进入项的区域: `mouseMoveEvent` 通常只在鼠标位于项的可见区域内时触发。如果您在项的外部移动鼠标，它不会被触发（除非您启用了全局的鼠标跟踪）。

其他更底层的事件处理: 极少数情况下，可能会有更低级别的事件过滤器（event filter）在您的项之前拦截了事件。

详细的解决方法

下面我们将针对以上原因提供详细的解决方法：

1. 确保已设置 `setAcceptHoverEvents(true)`

这是 最重要 的一点。您需要在创建 `QGraphicsRectItem` 子类时，或者在初始化函数中，调用 `setAcceptHoverEvents(true)` 来启用悬停事件的接收。

```cpp
include
include
include
include
include

class MyRectItem : public QGraphicsRectItem
{
public:
MyRectItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem parent = nullptr)
: QGraphicsRectItem(x, y, width, height, parent)
{
// 关键点：启用悬停事件
setAcceptHoverEvents(true);
// 如果您希望在鼠标按下时也能接收移动事件，也需要接受鼠标按下事件
// setAcceptedMouseButtons(Qt::LeftButton | Qt::RightButton); // 示例：接受左键和右键
}

protected:
// 处理鼠标进入事件
void hoverEnterEvent(QGraphicsSceneHoverEvent event) override
{
qDebug() << "Mouse entered the rectangle!";
QGraphicsRectItem::hoverEnterEvent(event); // 调用基类处理
}

// 处理鼠标离开事件
void hoverLeaveEvent(QGraphicsSceneHoverEvent event) override
{
qDebug() << "Mouse left the rectangle!";
QGraphicsRectItem::hoverLeaveEvent(event); // 调用基类处理
}

// 处理鼠标移动事件
void mouseMoveEvent(QGraphicsSceneMouseEvent event) override
{
qDebug() << "Mouse moved inside the rectangle at:" << event>pos();
// 您可以在这里实现拖动或其他逻辑
// 例如，改变项的位置：
// setPos(event>scenePos() event>pos());
QGraphicsRectItem::mouseMoveEvent(event); // 调用基类处理
}

// 还需要重写 mousePressEvent 来确保鼠标按下时事件能够继续传播到 mouseMoveEvent
void mousePressEvent(QGraphicsSceneMouseEvent event) override
{
qDebug() << "Mouse pressed inside the rectangle at:" << event>pos();
// 如果您想让鼠标按下时也能够拖动，在这里可以设置一个标志位
// 或者直接在这里开始拖动逻辑
QGraphicsRectItem::mousePressEvent(event); // 调用基类处理
}

void mouseReleaseEvent(QGraphicsSceneMouseEvent event) override
{
qDebug() << "Mouse released inside the rectangle at:" << event>pos();
QGraphicsRectItem::mouseReleaseEvent(event); // 调用基类处理
}
};

// 在您的主窗口或场景中创建和添加此项：
/
int main(int argc, char argv[])
{
QApplication a(argc, argv);

QGraphicsScene scene;
MyRectItem rect = new MyRectItem(0, 0, 100, 50);
rect>setBrush(Qt::blue);
rect>setFlag(QGraphicsItem::ItemIsMovable); // 如果你想让它可拖动，设置此标志
rect>setFlag(QGraphicsItem::ItemSendsGeometryChanges); // 如果需要处理几何变化

scene.addItem(rect);

QGraphicsView view(&scene);
view.setRenderHint(QPainter::Antialiasing);
view.resize(400, 300);
view.show();

return a.exec();
}
/
```

解释:

`setAcceptHoverEvents(true)` 告诉图形视图框架，当鼠标进入、离开或在 `MyRectItem` 的区域内移动时，应该生成并发送悬停事件。
`mouseMoveEvent` 确实是用来处理鼠标移动的，但是当鼠标没有按下时，它更像是 `hoverMoveEvent` 的一种延伸。如果您想在鼠标按下并移动时也触发 `mouseMoveEvent`，您还需要确保 `mousePressEvent` 没有阻止事件的传递，并且您的项已经设置了接受鼠标事件。

2. 确保项被添加到场景中并可见

`QGraphicsRectItem` 必须被添加到 `QGraphicsScene` 中，并且场景需要被 `QGraphicsView` 显示出来，鼠标事件才能被正确地传递。

3. 确保 `QGraphicsView` 启用了鼠标跟踪

尽管 `setAcceptHoverEvents(true)` 是项级别的设置，但如果您希望在鼠标 没有按下 的情况下也能接收到 `mouseMoveEvent`（这实际上更像是 `hoverMoveEvent` 的行为），您还需要确保 `QGraphicsView` 启用了鼠标跟踪。

```cpp
// 在创建 QGraphicsView 时
QGraphicsView view(&scene);
view.setMouseTracking(true); // 启用鼠标跟踪
view.show();
```

注意: 即使 `QGraphicsView::setMouseTracking(true)` 被调用，项本身仍然需要调用 `setAcceptHoverEvents(true)` 才能接收到鼠标移动事件。`setMouseTracking(true)` 只是确保 `QGraphicsView` 会不断地将鼠标移动事件发送给所有项，而项是否处理它们，取决于它们自己的设置。

4. 检查事件过滤和处理链

父项的事件处理: 如果您的 `MyRectItem` 是另一个 `QGraphicsItem` 的子项，检查父项的 `mouseMoveEvent` 实现。如果父项的 `mouseMoveEvent` 在处理完自己的逻辑后调用了 `event>ignore()`，那么事件将不会继续传递给子项。或者，如果父项设置了全局事件过滤器，该过滤器也可能拦截事件。
场景的事件处理: `QGraphicsScene` 本身也可能处理某些事件。检查 `QGraphicsScene::mouseMoveEvent` 或任何添加到场景的事件过滤器。
全局事件过滤器: 检查您的应用程序是否有全局事件过滤器（通过 `QCoreApplication::installEventFilter()` 安装的），它可能会拦截事件。

解决方法:
在您的 `MyRectItem` 的 `mouseMoveEvent` 中，确保您调用了 `QGraphicsRectItem::mouseMoveEvent(event)`，这样可以确保事件仍然能被基类处理，并且不意外地终止事件链。如果您想阻止事件继续向上（或向下）传递，可以在处理完后调用 `event>accept()`。

5. 确保鼠标在项的区域内

用鼠标在 `MyRectItem` 的边界内移动，而不是在外部。

6. 如果是拖动导致的问题

如果您在 `mousePressEvent` 中启动了拖动，并且希望在拖动过程中也响应 `mouseMoveEvent`，需要确保您的拖动逻辑是正确的。

通常，如果您只是想在鼠标按下并移动时改变项的位置，可以直接在 `mouseMoveEvent` 中修改 `item>setPos()`。如果您需要更复杂的拖动行为，可能需要使用 `QGraphicsScene::dragMoveEvent` 或其他更高级的拖动机制。

例如，一个简单的可拖动矩形：

```cpp
class DraggableRectItem : public QGraphicsRectItem
{
public:
DraggableRectItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem parent = nullptr)
: QGraphicsRectItem(x, y, width, height, parent)
{
setAcceptHoverEvents(true); // 依然需要接受悬停事件
setAcceptedMouseButtons(Qt::LeftButton); // 只接受左键按下
setFlag(QGraphicsItem::ItemIsMovable, true); // 设置为可移动的标志
}

protected:
// 当 ItemIsMovable 为 true 时，Qt 会自动处理大部分拖动逻辑，
// 包括在 mousePressEvent, mouseMoveEvent, mouseReleaseEvent 中。
// 所以通常不需要重写 mouseMoveEvent 来做简单的拖动。
// 但如果需要自定义行为，可以重写。

void mousePressEvent(QGraphicsSceneMouseEvent event) override
{
qDebug() << "DraggableRectItem mousePressEvent";
// 如果想覆盖默认的 ItemIsMovable 拖动行为，可以在这里处理
// 并调用 event>accept()
QGraphicsRectItem::mousePressEvent(event);
}

void mouseMoveEvent(QGraphicsSceneMouseEvent event) override
{
qDebug() << "DraggableRectItem mouseMoveEvent";
// 如果 setFlag(QGraphicsItem::ItemIsMovable, true);，
// Qt 已经替你处理了拖动逻辑，这里通常不需要手动修改 pos
// 除非你想添加额外的效果或控制。
QGraphicsRectItem::mouseMoveEvent(event);
}
};
```

在上面的 `DraggableRectItem` 示例中，设置 `setFlag(QGraphicsItem::ItemIsMovable, true)` 会让 Qt 自动处理鼠标按下、移动和释放事件来拖动项。在这种情况下，您可能不需要重写 `mouseMoveEvent`，除非您想在这个拖动过程中执行其他额外的操作。

总结和排查步骤

1. 最可能的原因: 忘记调用 `setAcceptHoverEvents(true)`。请务必在您的 `QGraphicsRectItem` 子类中添加这一行。
2. 确保 `QGraphicsView` 启用鼠标跟踪，尤其是在您希望鼠标未按下时也能触发事件的情况下。
3. 检查事件处理链: 确保没有父项或场景的事件处理函数意外地忽略或拦截了事件。
4. 确认鼠标位置: 确保鼠标是在您项的可见区域内移动。
5. 事件传递: 在您的重写函数中，始终考虑调用基类实现 (`QGraphicsRectItem::event(event)`)，以确保事件能够继续被处理。

通过遵循以上步骤和检查点，您应该能够解决 `QGraphicsRectItem` 子类无法接收 `mouseMoveEvent` 的问题。如果您仍然遇到困难，请提供更多关于您的代码结构和上下文的信息，以便更精确地诊断问题。

这是 Qt 的GraphicsItem的一项优化造成的，因为GraphicsItem不像QWidget只有很少的实例，GraphicsItem实例可以非常多，甚至可以到百万个，所以每次鼠标移动都去分发mouse move事件开销太大了，而且没必要，真正需要mouse move事件的item是很少的。

但是 Qt 提供了一个开关选项

void QGraphicsItem::setAcceptHoverEvents ( bool enabled )

打开这个选项，就可以接收到以下事件了

hoverEnterEvent(), hoverMoveEvent(), and hoverLeaveEvent().

那么mouseMoveEvent呢？在Qt Graphics item里mouse 的move和hover是不一样的。

hover是指鼠标经过，但是鼠标任何按键没有按下

move是指按下鼠标键后拖动，所以要先响应 mousePressEvent 返回 accepted，然后才会接收到move，只有响应了press的那个item才能接收到后续的move，直到mouseReleaseEvent。