如何实现类似setScenePos()的方法设置QGraphicsItem场景坐标？

嘿，这个需求我太熟悉了！Qt确实没有直接提供setScenePos()方法，但我们可以利用它的坐标转换机制轻松实现——核心思路就是把目标场景坐标转换成当前item父坐标系下的局部坐标，再调用setPos()。

为什么不能直接用setPos()？ #

因为QGraphicsItem::pos()返回的是相对于父item的坐标（如果没有父，则是场景坐标），而scenePos()是Qt帮我们把父层级的坐标变换都计算完后得到的绝对场景坐标。所以反过来设置的时候，我们需要做逆转换。

实现方法 #

这里分两种情况，但我们可以写一个统一的方法来处理：

C++ 版本

如果是子类化QGraphicsItem，可以添加这样一个成员函数：

void MyCustomItem::setScenePos(const QPointF& targetScenePos) {
    if (QGraphicsItem* parent = parentItem()) {
        // 把场景坐标转换为父item的局部坐标
        QPointF localPos = parent->mapFromScene(targetScenePos);
        setPos(localPos);
    } else {
        // 没有父item，直接用场景坐标作为局部坐标
        setPos(targetScenePos);
    }
}

Python/PyQt 版本

如果用PyQt/PySide，同样可以给自定义的item类加这个方法：

class MyCustomItem(QGraphicsItem):
    # ... 其他代码 ...
    def setScenePos(self, target_scene_pos):
        parent = self.parentItem()
        if parent:
            local_pos = parent.mapFromScene(target_scene_pos)
            self.setPos(local_pos)
        else:
            self.setPos(target_scene_pos)

原理说明 #

QGraphicsItem::mapFromScene()方法会自动处理所有父层级的坐标变换（包括平移、旋转、缩放等），把传入的场景坐标转换为调用该方法的item的局部坐标系坐标。这样不管你的item嵌套多少层，这个方法都能正确计算出它相对于直接父项的位置，确保最终场景坐标和你指定的一致。

验证例子 #

比如我们创建一个嵌套结构的item：

// 创建父item，放在场景的(50,50)位置
QGraphicsRectItem* parent = new QGraphicsRectItem(0,0,100,100);
parent->setPos(50,50);
scene->addItem(parent);

// 创建子item，加入父item组
MyCustomItem* child = new MyCustomItem();
parent->addToGroup(child);

// 设置子item的场景坐标为(100,100)
child->setScenePos(QPointF(100,100));

// 此时child的pos()应该是(50,50)，因为父在(50,50)，父的局部坐标(50,50)对应场景(100,100)
qDebug() << child->pos(); // 输出 QPointF(50,50)
qDebug() << child->scenePos(); // 输出 QPointF(100,100)

这样就完美实现了类似setScenePos()的功能，不管item的层级结构多复杂都能正常工作~

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