如何为QGraphicsPixmapItem设置鼠标碰撞盒？[QT/C++]

这问题我之前也碰到过，QGraphicsPixmapItem默认的像素级碰撞（依赖pixmap的alpha通道可见像素）确实有时候不符合需求，要改成基于整个pixmap宽高的矩形碰撞，核心是重写它的shape()函数——因为Qt的图形项碰撞检测、鼠标事件触发判断都是基于shape()返回的路径来做的。

具体实现思路 #

QGraphicsPixmapItem默认的shape()会生成一个贴合pixmap可见像素的复杂路径，我们只需要把它替换成一个覆盖整个boundingRect()的矩形路径就可以了。另外也可以选择重写contains()函数，但shape()的修改更通用，因为所有依赖碰撞检测的场景（比如鼠标事件、碰撞检测函数）都会用到它。

示例代码 #

#include <QGraphicsPixmapItem>
#include <QPainterPath>
#include <QDebug>

class RectCollisionPixmapItem : public QGraphicsPixmapItem
{
public:
    // 继承父类的构造函数
    using QGraphicsPixmapItem::QGraphicsPixmapItem;

protected:
    // 重写shape函数，返回覆盖整个pixmap的矩形路径
    QPainterPath shape() const override
    {
        QPainterPath path;
        // 添加boundingRect作为碰撞区域，正好是[0, 0, width, height]的矩形
        path.addRect(boundingRect());
        return path;
    }

    // 这里可以加上你需要重写的鼠标事件示例
    void mousePressEvent(QGraphicsSceneMouseEvent *event) override
    {
        // 现在点击整个pixmap矩形区域都会触发这个事件
        qDebug() << "Mouse pressed on pixmap rect area!";
        // 记得调用父类的事件实现，保证原有逻辑正常运行
        QGraphicsPixmapItem::mousePressEvent(event);
    }
};

补充说明 #

• boundingRect()是QGraphicsPixmapItem默认提供的方法，它返回的就是基于pixmap宽高的[0, 0, width, height]矩形区域，完全匹配你的需求。
• 如果只是单纯想让鼠标事件触发区域变成矩形，也可以选择重写contains()函数，示例如下：

bool contains(const QPointF &point) const override
{
    return boundingRect().contains(point);
}

不过更推荐重写shape()，因为它会影响所有和碰撞相关的逻辑（比如collidesWithItem()等函数），而不仅仅是鼠标事件。

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