PySide6中QGraphicsItem与QGraphicsScene坐标交互及边界限制问题

下面是基于PySide6的完整可运行代码，实现可移动矩形项的边界限制，同时澄清你困惑的坐标映射问题：

from PySide6.QtWidgets import (QApplication, QGraphicsScene, QGraphicsView,
                               QGraphicsRectItem)
from PySide6.QtCore import QPointF, Qt

class RestrictedRectItem(QGraphicsRectItem):
    def __init__(self, rect, parent=None):
        super().__init__(rect, parent)
        self.setFlag(QGraphicsItem.ItemIsMovable)
        # 必须开启这个标志，才能捕获位置变化事件
        self.setFlag(QGraphicsItem.ItemSendsGeometryChanges)

    def itemChange(self, change, value):
        if change == QGraphicsItem.ItemPositionChange and self.scene():
            # value是item即将移动到的目标pos（场景坐标系）
            new_pos = value
            corrected_pos = new_pos.copy()
            scene_rect = self.scene().sceneRect()

            # 计算item移动到new_pos后，在场景中的实际边界
            # 先把item自身的boundingRect转换为目标位置的自身坐标，再转场景坐标
            target_item_scene_rect = self.mapToScene(self.boundingRect().translated(new_pos - self.pos())).boundingRect()

            # 左边界检查：item左边缘不能小于场景左边界
            if target_item_scene_rect.left() < scene_rect.left():
                offset = scene_rect.left() - target_item_scene_rect.left()
                corrected_pos.setX(corrected_pos.x() + offset)
                # 更新修正后的场景边界，避免后续检查出错
                target_item_scene_rect = self.mapToScene(self.boundingRect().translated(corrected_pos - self.pos())).boundingRect()

            # 右边界检查：item右边缘不能大于场景右边界
            if target_item_scene_rect.right() > scene_rect.right():
                offset = scene_rect.right() - target_item_scene_rect.right()
                corrected_pos.setX(corrected_pos.x() + offset)
                target_item_scene_rect = self.mapToScene(self.boundingRect().translated(corrected_pos - self.pos())).boundingRect()

            # 上边界检查
            if target_item_scene_rect.top() < scene_rect.top():
                offset = scene_rect.top() - target_item_scene_rect.top()
                corrected_pos.setY(corrected_pos.y() + offset)
                target_item_scene_rect = self.mapToScene(self.boundingRect().translated(corrected_pos - self.pos())).boundingRect()

            # 下边界检查
            if target_item_scene_rect.bottom() > scene_rect.bottom():
                offset = scene_rect.bottom() - target_item_scene_rect.bottom()
                corrected_pos.setY(corrected_pos.y() + offset)

            # 打印调试坐标，对比目标位置和修正后位置
            print(f"目标X: {new_pos.x():.2f}, 修正后X: {corrected_pos.x():.2f}")
            return corrected_pos

        return super().itemChange(change, value)

if __name__ == "__main__":
    app = QApplication([])
    view = QGraphicsView()
    scene = QGraphicsScene()
    # 明确设置场景边界，这是限制的基准
    scene.setSceneRect(0, 0, 400, 300)
    view.setScene(scene)

    # 创建50x50的蓝色方块，自身坐标系的(0,0)是左上角
    rect_item = RestrictedRectItem(0, 0, 50, 50)
    rect_item.setBrush(Qt.blue)
    scene.addItem(rect_item)

    view.show()
    app.exec()

关键坐标概念澄清 #

• Item自身坐标系：pos()表示item自身原点（默认是boundingRect左上角）在场景坐标系中的位置。item内部的绘制、矩形定义都是基于自身坐标系，比如QGraphicsRectItem(0,0,50,50)的左上角是item自己的(0,0)，不是场景的(0,0)。
• 场景坐标系：sceneRect()定义了场景的有效边界，所有item的位置最终都映射到这个坐标系下。
• mapToScene()的正确用法：要获取item在场景中的实际占据区域，需要把item的boundingRect()（自身坐标）转换为场景坐标，再用.boundingRect()合并成一个场景中的矩形。

你之前的问题根源 #

你可能混淆了item的pos()和item边缘的场景坐标：比如item宽50，当pos().x()为0时，item左边缘刚好在场景左边界（0）；如果pos().x()为-20，左边缘就是-20，超出场景。所以不能只看pos()是否趋近于0，要检查item整个边缘的场景坐标。

核心逻辑说明 #

1. 开启ItemSendsGeometryChanges标志：这是捕获位置变化事件的前提，否则itemChange不会收到ItemPositionChange信号。
2. 计算目标位置的场景边界：用boundingRect().translated(new_pos - self.pos())得到item移动到目标位置后的自身坐标系矩形，再转换为场景坐标。
3. 边界修正：针对四个边界分别计算偏移量，调整corrected_pos，确保item边缘不超出场景边界，最后返回修正后的位置，Qt会自动使用这个位置作为item的最终位置。

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