PyQt5访问QLabel显示图片及解决保存功能报错问题

问题原因分析 #

• 控件缺失：代码中self.imglabl和self.tabWidget未在setupUi中定义，运行时触发属性不存在错误，导致崩溃。
• 信号槽参数不匹配：saveFileDialog函数定义了多余的file_name参数，但QPushButton.clicked信号无参数传递，引发调用崩溃（对应错误码0xC0000409）。
• 无实际保存逻辑：仅打印保存路径，未执行图片写入操作，导致图片无法保存。
• 字符串拼接错误：print("File saved as" + file)中file是元组（文件名、过滤器），直接拼接触发类型错误。

修正后的完整代码 #

from PyQt5 import QtCore, QtGui, QtWidgets
from PyQt5.QtWidgets import QFileDialog

class Ui_MainWindow(object):
    def setupUi(self, MainWindow):
        MainWindow.setObjectName("MainWindow")
        MainWindow.resize(1314, 1327)
        self.centralwidget = QtWidgets.QWidget(MainWindow)
        self.centralwidget.setObjectName("centralwidget")
        
        # 读取按钮
        self.Read_Button = QtWidgets.QPushButton(self.centralwidget)
        self.Read_Button.setGeometry(QtCore.QRect(70, 140, 75, 23))
        self.Read_Button.setObjectName("Read_Button")
        self.Read_Button.setText("读取图片")
        
        # 保存按钮
        self.Write_Button = QtWidgets.QPushButton(self.centralwidget)
        self.Write_Button.setGeometry(QtCore.QRect(70, 180, 75, 23))
        self.Write_Button.setObjectName("Write_Button")
        self.Write_Button.setText("保存图片")
        
        # 添加显示图片的QLabel（原代码缺失）
        self.imglabl = QtWidgets.QLabel(self.centralwidget)
        self.imglabl.setGeometry(QtCore.QRect(200, 100, 800, 800))
        self.imglabl.setObjectName("imglabl")
        self.imglabl.setFrameShape(QtWidgets.QFrame.Box)  # 加边框方便识别
        
        MainWindow.setCentralWidget(self.centralwidget)
        self.retranslateUi(MainWindow)
        QtCore.QMetaObject.connectSlotsByName(MainWindow)
        
        # 绑定信号槽
        self.Read_Button.clicked.connect(self.setImage)
        self.Write_Button.clicked.connect(self.saveFileDialog)

    def retranslateUi(self, MainWindow):
        _translate = QtCore.QCoreApplication.translate
        MainWindow.setWindowTitle(_translate("MainWindow", "图片浏览保存工具"))

    def setImage(self):
        fileName, _ = QtWidgets.QFileDialog.getOpenFileName(
            None, "选择图片", "", "Image Files (*.png *.jpg *jpeg *.bmp);;All Files (*)"
        )
        if fileName:
            pixmap = QtGui.QPixmap(fileName)
            # 按QLabel尺寸等比例缩放
            pixmap = pixmap.scaled(
                self.imglabl.width(), self.imglabl.height(), 
                QtCore.Qt.KeepAspectRatio, QtCore.Qt.SmoothTransformation
            )
            self.imglabl.setPixmap(pixmap)
            self.imglabl.setAlignment(QtCore.Qt.AlignCenter)

    def saveFileDialog(self):
        # 移除多余的file_name参数，匹配clicked信号的无参数传递
        options = QFileDialog.Options()
        options |= QFileDialog.DontUseNativeDialog
        
        file_path, _ = QFileDialog.getSaveFileName(
            None, "保存图片", "", "PNG Files (*.png);;JPG Files (*.jpg);;All Files (*)"
        )
        
        if file_path:
            # 获取QLabel上显示的Pixmap
            pixmap = self.imglabl.pixmap()
            if pixmap:
                # 保存图片到指定路径
                success = pixmap.save(file_path)
                if success:
                    print(f"图片已保存至: {file_path}")
                else:
                    print("图片保存失败")
            else:
                print("当前没有显示可保存的图片")

if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    MainWindow = QtWidgets.QMainWindow()
    ui = Ui_MainWindow()
    ui.setupUi(MainWindow)
    MainWindow.show()
    sys.exit(app.exec_())

关键修复点说明 #

• 补充self.imglabl的定义：在setupUi中创建用于显示图片的QLabel，指定位置和尺寸，解决原代码中找不到控件的崩溃问题。
• 修正saveFileDialog的参数：移除多余的file_name参数，确保与clicked信号的参数匹配，避免调用崩溃。
• 添加图片保存逻辑：通过self.imglabl.pixmap()获取当前显示的图片，调用pixmap.save(file_path)完成保存。
• 优化字符串打印：使用f-string格式化输出，避免元组与字符串拼接的错误。

如何访问QLabel上显示的图片 #

要获取QLabel上已显示的图片，直接调用QLabel的pixmap()方法即可，该方法返回当前设置的QPixmap对象（如果没有设置则返回None）。获取后可以进行保存、裁剪、转换格式等操作：

# 获取QLabel的图片
pixmap = self.imglabl.pixmap()
if pixmap:
    # 示例：保存为PNG格式
    pixmap.save("output.png")
    # 示例：转换为QImage
    image = pixmap.toImage()

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