PyQt5中如何保存并隐藏/显示QGraphicsScene标记点，规避工具冲突

核心需求实现方案 #

1. 保存标记控件 #

在场景类中定义一个列表（如self.markers = []），每次添加标记点时，将对应的QGraphicsItem对象存入该列表，后续需要调用标记（比如隐藏、显示、删除）时，直接遍历列表操作即可。

2. 右键添加标记点 #

• 新增一个状态变量（如self.is_mark_mode）控制标记模式的开启/关闭，点击标记按钮时切换该状态。
• 重写QGraphicsScene的mousePressEvent方法，当处于标记模式且检测到右键点击时，获取点击的场景坐标，创建标记项（比如用QEllipseItem做红色小点），将其添加到场景的同时存入标记列表。

3. 标记点隐藏/显示 #

给切换按钮绑定槽函数，遍历标记列表，调用每个标记项的setVisible()方法切换显示状态。

主QPixmap消失问题解决 #

这个问题大多是因为错误地将主图设置为场景背景，或者添加标记时误操作移除了主图项。正确的做法是：

• 将主图以QGraphicsPixmapItem的形式添加到场景，而非设置为场景背景，这样主图和标记点是同级的场景元素，不会互相覆盖或清除。
• 确保添加标记的逻辑中没有删除主图项的代码，同时可以给主图项设置合适的zValue（比如self.pixmap_item.setZValue(-1)），让标记点显示在主图上方。

完整可运行代码 #

import sys
from PyQt5.QtWidgets import (QApplication, QMainWindow, QGraphicsView, QGraphicsScene, 
                             QGraphicsPixmapItem, QEllipseItem, QPushButton, QVBoxLayout, QWidget)
from PyQt5.QtGui import QPixmap, QMouseEvent
from PyQt5.QtCore import Qt, QPointF

class MarkerScene(QGraphicsScene):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.is_mark_mode = False
        self.markers = []  # 存储所有标记点

    def mousePressEvent(self, event: QMouseEvent):
        # 仅在标记模式下响应右键点击
        if self.is_mark_mode and event.button() == Qt.RightButton:
            scene_pos = self.scenePos(event)
            # 创建5x5的红色椭圆标记点
            marker = QEllipseItem(scene_pos.x()-2.5, scene_pos.y()-2.5, 5, 5)
            marker.setBrush(Qt.red)
            self.addItem(marker)
            self.markers.append(marker)
        # 调用父类方法保证其他事件正常响应
        super().mousePressEvent(event)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("标记点工具")
        self.resize(800, 600)

        # 初始化场景和视图
        self.scene = MarkerScene()
        self.view = QGraphicsView(self.scene)

        # 加载主图并添加为场景元素（关键：不是设置背景）
        self.main_pixmap = QPixmap("test_image.jpg")  # 替换为你的图片路径
        self.pixmap_item = QGraphicsPixmapItem(self.main_pixmap)
        self.pixmap_item.setZValue(-1)  # 让主图在标记点下方
        self.scene.addItem(self.pixmap_item)

        # 按钮布局
        self.btn_mark = QPushButton("开启标记模式")
        self.btn_mark.clicked.connect(self.toggle_mark_mode)
        self.btn_toggle_visible = QPushButton("切换标记显示")
        self.btn_toggle_visible.clicked.connect(self.toggle_markers_visible)

        central_widget = QWidget()
        layout = QVBoxLayout(central_widget)
        layout.addWidget(self.view)
        layout.addWidget(self.btn_mark)
        layout.addWidget(self.btn_toggle_visible)
        self.setCentralWidget(central_widget)

    def toggle_mark_mode(self):
        self.scene.is_mark_mode = not self.scene.is_mark_mode
        self.btn_mark.setText("关闭标记模式" if self.scene.is_mark_mode else "开启标记模式")

    def toggle_markers_visible(self):
        for marker in self.scene.markers:
            marker.setVisible(not marker.isVisible())

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

关键细节说明 #

• 主图作为独立的QGraphicsPixmapItem存在，彻底避免了背景被覆盖的问题。
• 标记模式通过状态变量控制，防止误操作添加标记。
• 标记点统一存入列表，批量操作更高效。

内容的提问来源于stack exchange，提问作者md.119