PyQt5自定义Labella类：GUI资源访问与事件传递问题咨询

核心问题分析 #

1. Labella无法访问Principal的UI控件：Labella是QLabel的子类，作为Principal中ui.labelimage的实例存在，它本身没有ui属性，直接调用self.ui.labelroi自然会报错。GUI控件的访问应遵循职责分离，子控件不直接操作父窗口的其他控件，而是通过信号传递数据，由父窗口处理UI更新。
2. 让Principal感知Labella的mouseReleaseEvent：利用PyQt的自定义信号与槽机制，在Labella中定义信号，当mouseReleaseEvent触发时发射信号，Principal中连接该信号到自己的槽函数，实现事件通知。

代码修改步骤 #

1. 修改Labella类，添加自定义信号 #

在Labella类中定义一个用于传递ROI图像的自定义信号：

from PyQt5 import QtCore, QtGui, QtWidgets
from PyQt5.QtGui import QPixmap, QImage

class Labella(QtWidgets.QLabel):
    # 定义自定义信号，参数为QPixmap类型的ROI图像
    roi_selected = QtCore.pyqtSignal(QPixmap)
    file_n = ''

    def __init__(self, parent):
        super().__init__(parent=parent)
        self.drawing_flg = False
        self.ini_coord = QtCore.QPoint()
        self.fin_coord = QtCore.QPoint()
        self.exist_img_flg = 0
        self.rect_roi = QtCore.QRect()
    
    def convertPixmap(self, fileN):
        Labella.file_n = fileN
        pixmapformat = QPixmap(Labella.file_n)
        return pixmapformat    

    def verifyPixmap(self):
        self.exist_img_flg = 1 if self.pixmap() else 0        
   
    def deleteRect(self):
        if self.rect_roi:
            self.ini_coord = self.fin_coord = QtCore.QPoint()
            self.update()

    def paintEvent(self, event):
        super().paintEvent(event)
        qp = QtGui.QPainter(self)
        qp.setPen(QtGui.QPen(QtCore.Qt.red, 1, QtCore.Qt.SolidLine))
        if self.ini_coord and self.fin_coord and self.exist_img_flg == 1:
            self.rect_roi = QtCore.QRect(self.ini_coord, self.fin_coord)
            qp.drawRect(self.rect_roi)

    def mousePressEvent(self, event):
        self.verifyPixmap()
        if event.button() == QtCore.Qt.LeftButton and self.exist_img_flg == 1:
            self.drawing_flg = True
            self.ini_coord = self.fin_coord = event.pos() 
        else:
            self.drawing_flg = False

    def mouseMoveEvent(self, event):
        if self.drawing_flg:
            self.fin_coord = event.pos()
            self.update()

    def mouseReleaseEvent(self, event):
        if self.drawing_flg:
            self.drawing_flg = False
            self.update()
            r_img = self.createMappedROI()
            # 发射自定义信号，传递ROI图像
            self.roi_selected.emit(r_img)
        
    def createMappedROI(self):
        pixmap_size_Rect = self.pixmap().rect()
        contents_label_Rect = QtCore.QRectF(self.contentsRect())
    
        width_rate = pixmap_size_Rect.width() / contents_label_Rect.width()
        height_rate = pixmap_size_Rect.height() / contents_label_Rect.height()
    
        mapped_roi = QtCore.QRect(
            int(self.rect_roi.x() * width_rate), 
            int(self.rect_roi.y() * height_rate), 
            int(self.rect_roi.width() * width_rate), 
            int(self.rect_roi.height() * height_rate)
        )

        qimage = QImage()
        qimage.load(Labella.file_n)
        crop_image = qimage.copy(mapped_roi)
        roi_image = QPixmap.fromImage(crop_image)
    
        return roi_image

2. 修改Principal类，连接信号与槽 #

在Principal的初始化方法中，连接Labella的自定义信号到槽函数，处理ROI图像的显示：

import sys
sys.path.append("../cursoqt/sample_editor")

from PyQt5.QtWidgets import QApplication, QFileDialog, QMainWindow
from PyQt5.QtGui import QImage, QPixmap, QPainter, QPen, QGuiApplication
from PyQt5.QtCore import Qt, QtCore

from paint_rectangle import *  # GUI generated by pyqt designer
from labella import *  # Qlabel promoted class

class Principal(QMainWindow):
    file_name = ''

    def __init__(self):
        super().__init__()      
        self.roi = QtCore.QRect()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)

        # 连接Labella的自定义信号到槽函数
        self.ui.labelimage.roi_selected.connect(self.update_roi_label)
        self.ui.pushButtonexp.clicked.connect(self.openFile)            
        
        self.show()

    def openFile(self):
        file_name, _ = QFileDialog.getOpenFileName(self, 'Open file', '/home', "Images (*.png *.jpg)")
    
        if file_name != '':
            # 修正：convertPixmap是实例方法，用labelimage实例调用
            img_pixmap = self.ui.labelimage.convertPixmap(file_name)
            self.displayImg(img_pixmap)
        else:
            self.ui.labelimage.deleteRect()
    
    def displayImg(self, pixmap):
        if pixmap.isNull():             
            self.ui.labelimage.clear()
            self.ui.labelimage.deleteRect()
        else:
            self.ui.labelimage.deleteRect()
            self.ui.labelimage.setPixmap(pixmap)
            self.ui.labelimage.setCursor(Qt.CrossCursor)

    # 新增槽函数，接收ROI图像并显示
    def update_roi_label(self, roi_pixmap):
        self.ui.labelroi.setPixmap(roi_pixmap)

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

关键说明 #

• 信号与槽的优势：实现了控件间的解耦，Labella只负责绘制ROI并生成图像，无需关心后续UI逻辑；Principal统一处理所有UI组件的协调，符合单一职责原则。
• 实例调用修正：原代码中Labella.convertPixmap(self, file_name)是错误用法，convertPixmap是Labella的实例方法，需通过self.ui.labelimage（Labella的实际实例）调用。

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