Qt同QGraphicsScene插入QGraphicsWidget时setZValue无效问题咨询

根因说明 #

• setZValue不生效：QGraphicsItem默认初始z值为0，同z值下按插入顺序决定堆叠顺序。手动设置z值无效的核心原因通常是子类重载itemChange()方法时未调用父类实现，导致z值变更事件未同步到QGraphicsScene，也可能是item异常开启了ItemStacksBehindParent等堆叠相关标志覆盖了默认规则。
• collidingItems返回空：碰撞检测依赖boundingRect()、shape()两个方法的返回值，如果子类重写这两个方法时返回了空值、或返回范围与实际绘制区域不符，就会出现视觉重叠但检测不到碰撞的问题。

修复步骤 #

1. 补全子类itemChange实现
   如果你的QGraphicsWidget0、QGraphicsWidget1子类重载了itemChange()方法，必须添加父类调用逻辑，否则所有item属性变更都不会同步到场景：

QVariant QGraphicsWidget0::itemChange(GraphicsItemChange change, const QVariant &value)
{
    // 必须调用父类实现，不能直接返回自定义值
    return QGraphicsWidget::itemChange(change, value);
}

两个子类都需要按上述规则修改，未重载该方法可跳过此步骤。

2. 调整层级设置逻辑
   不需要修改插入顺序，明确给两个item设置z值并强制刷新场景即可：

icon0= new QGraphicsWidget0();
icon1= new QGraphicsWidget1();
scene.addItem(icon0);
scene.addItem(icon1);
// 数值越大层级越高，此处设置icon0显示在icon1上方
icon0->setZValue(2);
icon1->setZValue(1);
// 强制刷新场景堆叠顺序
scene.invalidate();

3. 修复碰撞检测逻辑
   检查两个子类的boundingRect()实现，确保返回范围与实际绘制区域一致，示例：

QRectF QGraphicsWidget0::boundingRect() const
{
    // 按实际绘制尺寸修改返回值，禁止返回空矩形
    return QRectF(0, 0, 自定义宽度, 自定义高度);
}

无特殊需求不要重写shape()方法，直接使用父类实现即可。调用碰撞检测时可明确指定检测规则：

// 按边界矩形检测碰撞，也可根据需求替换为Qt::IntersectsItemShape等规则
QList<QGraphicsItem*> collideList = icon1->collidingItems(Qt::IntersectsItemBoundingRect);

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