如何隐藏移出边界的QGraphicsPixmapItem超出部分？

刚好做过类似的需求，给你分享几个实用的实现思路，都能完美达成你要的「超出指定边界就隐藏部分内容」的效果：

方案一：用裁剪路径快速实现（最推荐） #

如果你的边界是固定矩形（不管是QGraphicsScene的范围还是自定义的固定帧），直接给item设置裁剪路径是最省事的方法，完全不影响item的移动、选择功能。

步骤很简单：

• 先定义好你要限制的边界矩形，比如我这里用QRectF(0, 0, 800, 600)作为示例
• 给你的QGraphicsPixmapItem添加裁剪路径：

// 假设你的item是pixmapItem，boundRect是你定义的边界矩形
QPainterPath clipPath;
clipPath.addRect(boundRect);
pixmapItem->setClipPath(clipPath);

设置完之后，item只要超出这个矩形的部分就会自动被裁剪隐藏，和你示例里篮球左侧被隐藏的效果完全一致。

方案二：重写paint方法自定义裁剪（适合复杂边界） #

如果你的边界不是矩形（比如圆形、不规则形状），或者需要更灵活的裁剪逻辑，那就自定义一个继承自QGraphicsPixmapItem的类，重写它的paint方法手动控制裁剪：

class ClippedPixmapItem : public QGraphicsPixmapItem
{
public:
    ClippedPixmapItem(const QPixmap& pixmap, QGraphicsItem* parent = nullptr)
        : QGraphicsPixmapItem(pixmap, parent) {}

    void paint(QPainter* painter, const QStyleOptionGraphicsItem* option, QWidget* widget) override
    {
        // 这里可以换成你自己的自定义边界，示例用场景的矩形作为裁剪范围
        QRectF clipRect = scene()->sceneRect();
        
        // 先保存画家当前状态，避免影响其他绘制
        painter->save();
        // 设置裁剪区域
        painter->setClipRect(clipRect);
        // 调用父类的paint方法绘制图片
        QGraphicsPixmapItem::paint(painter, option, widget);
        // 恢复画家状态
        painter->restore();
    }
};

之后用这个自定义类创建你的图片item，再设置ItemIsMovable和ItemIsSelectable标志就可以了。

方案三：利用场景+视图的裁剪（仅适用于场景范围为边界） #

如果你的边界刚好就是QGraphicsScene的范围，那甚至不用修改item，直接设置场景和视图的参数就行：

// 设置场景的有效范围
scene->setSceneRect(0, 0, 800, 600);
// 让视图的显示范围和场景一致
view->setSceneRect(scene->sceneRect());
// 确保视图开启裁剪（默认是开启的，这里可以明确设置）
view->setViewportUpdateMode(QGraphicsView::FullViewportUpdate);

这样视图会自动裁剪掉场景范围外的内容，也能达到你要的效果。

小提示：如果是固定矩形边界，优先用方案一，代码最少效果最直接；如果是复杂边界再考虑方案二。

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