如何让QGraphicsPixmapItem选中时仅高亮不透明区域而非矩形？

这个场景我之前处理过！Qt默认的选中高亮框是基于shape()函数返回的路径绘制的，而原生QGraphicsPixmapItem的shape()直接对应它的boundingRect()，所以不管你的图片有没有透明背景，都会画出一个完整的矩形虚线框。要实现只包围不透明区域（比如你说的菱形）的高亮效果，核心就是自定义子类并重写shape()方法。

具体实现步骤 #

1. 自定义QGraphicsPixmapItem子类 #

创建一个继承自QGraphicsPixmapItem的子类，比如TransparentAwarePixmapItem，在这个类里重写shape()函数，让它返回我们想要的不透明区域轮廓路径。

2. 生成对应不透明区域的路径 #

根据你的图片形状，有两种实现思路：

• 规则形状（如菱形）：手动构建对应形状的QPainterPath
• 任意透明形状：从图片的Alpha通道提取不透明区域，生成精确的轮廓路径

完整代码示例 #

下面是两种思路的代码实现，你可以根据自己的需求选择：

#include <QGraphicsPixmapItem>
#include <QPainterPath>
#include <QImage>

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

    QPainterPath shape() const override
    {
        const QPixmap& pix = pixmap();
        if (pix.isNull()) {
            return QGraphicsPixmapItem::shape();
        }

        // --- 思路1：针对规则形状（比如菱形），手动绘制路径 ---
        QRectF rect = boundingRect();
        QPainterPath path;
        path.moveTo(rect.center().x(), rect.top());
        path.lineTo(rect.right(), rect.center().y());
        path.lineTo(rect.center().x(), rect.bottom());
        path.lineTo(rect.left(), rect.center().y());
        path.closeSubpath();
        return path;

        // --- 思路2：针对任意透明形状，从Alpha通道提取精确路径 ---
        // QImage img = pix.toImage();
        // QPainterPath precisePath;
        // const int alphaThreshold = 128; // 半透明判断阈值，可调整
        // for (int y = 0; y < img.height(); ++y) {
        //     uchar* scanline = img.scanLine(y);
        //     bool inOpaqueArea = false;
        //     int startX = 0;
        //     // 遍历当前行的每个像素的Alpha通道
        //     for (int x = 0; x < img.width(); ++x) {
        //         uchar alpha = scanline[4 * x + 3]; // RGBA格式，第4位是Alpha
        //         if (alpha > alphaThreshold && !inOpaqueArea) {
        //             startX = x;
        //             inOpaqueArea = true;
        //         } else if (alpha <= alphaThreshold && inOpaqueArea) {
        //             precisePath.addRect(startX, y, x - startX, 1);
        //             inOpaqueArea = false;
        //         }
        //     }
        //     // 处理行尾仍在不透明区域的情况
        //     if (inOpaqueArea) {
        //         precisePath.addRect(startX, y, img.width() - startX, 1);
        //     }
        // }
        // return precisePath;
    }
};

3. 替换原生类并使用 #

在你的业务代码里，用自定义的子类替换原来的QGraphicsPixmapItem，再设置对应的标志即可：

auto customItem = new TransparentAwarePixmapItem(QPixmap("your_diamond_image.png"));
customItem->setFlag(QGraphicsItem::ItemIsMovable, true);
customItem->setFlag(QGraphicsItem::ItemIsSelectable, true);
yourScene->addItem(customItem);

额外优化提示 #

如果你的图片是复杂形状且尺寸较大，推荐给生成的QPainterPath加缓存——比如在setPixmap()方法里预先生成路径并保存，避免每次调用shape()都重复计算，提升性能。

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