PyQt5桌面应用开发（6）：文件对话框

已于 2024-07-23 08:17:41 修改
阅读量1.3k 收藏 6
点赞数 3
分类专栏： PyQt5界面设计 Python 文章标签： qt python 开发语言
于 2023-05-02 17:00:26 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/withstand/article/details/130465003
版权

本文目录

PyQt5桌面应用系列

介绍

读入和写文件是一个GUI程序的常用操作。前者导入需要处理的数据，后者把数据输出到硬盘上后期使用。PyQt5提供了PyQt5.QtWidgets.QFileDialog类来完成常用的文件打开、文件存储的功能。

这个类有两个接口形式。第一种形式采用静态函数，调用的方式就是QFileDialog.method()，比如QFileDialog.getOpenFileName()。第二种形式需要先创建一个QFileDialog对象，然后调用对象的method()方法，比如QFileDialog().getOpenFileName()。

QFileDialog的静态接口

方便使用的静态函数包括下面的函数：

    def getExistingDirectory(self, parent, QWidget=None, *args, **kwargs): # real signature unknown; NOTE: unreliably restored from __doc__ 
        """ getExistingDirectory(parent: typing.Optional[QWidget] = None, caption: str = '', directory: str = '', options: Union[QFileDialog.Options, QFileDialog.Option] = QFileDialog.ShowDirsOnly) -> str """
        pass

    def getExistingDirectoryUrl(self, parent, QWidget=None, *args, **kwargs): # real signature unknown; NOTE: unreliably restored from __doc__ 
        """ getExistingDirectoryUrl(parent: typing.Optional[QWidget] = None, caption: str = '', directory: QUrl = QUrl(), options: Union[QFileDialog.Options, QFileDialog.Option] = QFileDialog.ShowDirsOnly, supportedSchemes: Iterable[str] = []) -> QUrl """
        pass

    def getOpenFileName(self, parent, QWidget=None, *args, **kwargs): # real signature unknown; NOTE: unreliably restored from __doc__ 
        """ getOpenFileName(parent: typing.Optional[QWidget] = None, caption: str = '', directory: str = '', filter: str = '', initialFilter: str = '', options: Union[QFileDialog.Options, QFileDialog.Option] = 0) -> Tuple[str, str] """
        pass

    def getOpenFileNames(self, parent, QWidget=None, *args, **kwargs): # real signature unknown; NOTE: unreliably restored from __doc__ 
        """ getOpenFileNames(parent: typing.Optional[QWidget] = None, caption: str = '', directory: str = '', filter: str = '', initialFilter: str = '', options: Union[QFileDialog.Options, QFileDialog.Option] = 0) -> Tuple[List[str], str] """
        pass

    def getOpenFileUrl(self, parent, QWidget=None, *args, **kwargs): # real signature unknown; NOTE: unreliably restored from __doc__ 
        """ getOpenFileUrl(parent: typing.Optional[QWidget] = None, caption: str = '', directory: QUrl = QUrl(), filter: str = '', initialFilter: str = '', options: Union[QFileDialog.Options, QFileDialog.Option] = 0, supportedSchemes: Iterable[str] = []) -> Tuple[QUrl, str] """
        pass

    def getOpenFileUrls(self, parent, QWidget=None, *args, **kwargs): # real signature unknown; NOTE: unreliably restored from __doc__ 
        """ getOpenFileUrls(parent: typing.Optional[QWidget] = None, caption: str = '', directory: QUrl = QUrl(), filter: str = '', initialFilter: str = '', options: Union[QFileDialog.Options, QFileDialog.Option] = 0, supportedSchemes: Iterable[str] = []) -> Tuple[List[QUrl], str] """
        pass

    def getSaveFileName(self, parent, QWidget=None, *args, **kwargs): # real signature unknown; NOTE: unreliably restored from __doc__ 
        """ getSaveFileName(parent: typing.Optional[QWidget] = None, caption: str = '', directory: str = '', filter: str = '', initialFilter: str = '', options: Union[QFileDialog.Options, QFileDialog.Option] = 0) -> Tuple[str, str] """
        pass

    def getSaveFileUrl(self, parent, QWidget=None, *args, **kwargs): # real signature unknown; NOTE: unreliably restored from __doc__ 
        """ getSaveFileUrl(parent: typing.Optional[QWidget] = None, caption: str = '', directory: QUrl = QUrl(), filter: str = '', initialFilter: str = '', options: Union[QFileDialog.Options, QFileDialog.Option] = 0, supportedSchemes: Iterable[str] = []) -> Tuple[QUrl, str] """
        pass

可以很方便的打开目录、多文件、单文件，保存文件。函数的返回值第一就是文件的路径，第二个是文件的类型。如果采用Url的形式，则可以打开类似于PyQt5.QtCore.QUrl('file:///C:/Users/User/qchen/pyqt5/chart1.py')的形式，这种方式应该还可以很方便的打开ftp等形式的文件。

QFileDialog的对象接口

采用对象的接口也非常直观。

  1. 创建一个QFileDialog对象；
  2. 调用QFileDialog对象的setWindowTitle()方法设置标题；
  3. 调用QFileDialog对象的setDirectory()方法设置默认打开的目录；
  4. 调用QFileDialog对象的setNameFilter()方法设置文件过滤器；
  5. 调用QFileDialog对象的setFileMode()方法设置文件模式；
  6. 调用QFileDialog对象的setViewMode()方法设置视图模式；
  7. 调用QFileDialog对象的setOption()方法设置对话框的选项；
  8. 调用QFileDialog对象的open()方法打开对话框；
  9. 调用QFileDialog对象的selectedFiles()方法获取选中的文件，或者调用QFileDialog对象的selectedUrl()方法获取选中的文件的Url。

示例

下面的示例代码演示了如何使用QFileDialog类。

import sys
from functools import partial

from PyQt5.QtGui import QIcon
from PyQt5.QtWidgets import QApplication, QMainWindow, QMenuBar, QAction, QTextEdit, QFileDialog, QWidget, QStatusBar, \
    QToolBar, QStyle

current_file: str = None


def open_file_func(parent: QWidget, content: QTextEdit, checked: bool):
    try:
        file, current_filter = QFileDialog.getOpenFileName(parent,
                                                           "Open File",
                                                           ".",
                                                           "Text Files (*.txt);;Python Files (*.py);;Markdown Files ("
                                                           "*.md)")

        with open(file, "r", encoding="utf-8") as fid:
            content.setText(fid.read())
            global current_file
            current_file = file
            if isinstance(parent, QMainWindow):
                parent: QMainWindow
                parent.statusBar().showMessage(f"Opened {file}")
                parent.setWindowTitle(file)
    except Exception as e:
        content.setText(f"<b style='color:#FF0000'>{str(e)}</b>")
        current_file = None


def save_file_func(parent: QWidget, content: QTextEdit, checked: bool):
    try:
        global current_file
        if current_file is None:
            save_as_file_func(parent, content, checked)
            return
        with open(current_file, "w", encoding="utf-8") as fid:
            fid.write(content.toPlainText())
            if isinstance(parent, QMainWindow):
                parent: QMainWindow
                parent.statusBar().showMessage(f"Saved {current_file}")
                parent.setWindowTitle(current_file)
    except Exception as e:
        content.setText(f"<b style='color:#FF0000'>{str(e)}</b>")
        current_file = None


def save_as_file_func(parent: QWidget, content: QTextEdit, checked: bool):
    try:
        file, current_filter = QFileDialog.getSaveFileName(parent,
                                                           "Open File",
                                                           ".",
                                                           "Text Files (*.txt);;Python Files (*.py);;Markdown Files ("
                                                           "*.md)")
        with open(file, "w", encoding="utf-8") as fid:
            fid.write(content.toPlainText())
            global current_file
            current_file = file
            if isinstance(parent, QMainWindow):
                parent: QMainWindow
                parent.statusBar().showMessage(f"Saved {file}")
                parent.setWindowTitle(file)
    except Exception as e:
        content.setText(f"<b style='color:#FF0000'>{str(e)}</b>")
        current_file = None


def file_edited(parent: QMainWindow):
    parent: QMainWindow
    if current_file == parent.windowTitle():
        parent.setWindowTitle(f"{current_file}*")


if __name__ == '__main__':
    app = QApplication(sys.argv)

    mw = QMainWindow()
    content_edit = QTextEdit(mw)
    menu = QMenuBar(mw)
    sb = QStatusBar(mw)
    tb = QToolBar(mw)

    content_edit.textChanged.connect(partial(file_edited, mw))

    mw.setMenuBar(menu)
    mw.setCentralWidget(content_edit)
    mw.setStatusBar(sb)
    mw.addToolBar(tb)

    file_menu = menu.addMenu("&File")

    open_file = QAction("Open", mw)
    open_file.setShortcut("Ctrl+O")
    open_file.setIcon(mw.style().standardIcon(QStyle.SP_DialogOpenButton))
    open_file.triggered.connect(partial(open_file_func, mw, content_edit))

    save_as_file = QAction("Save as", mw)
    save_as_file.setShortcut("Ctrl+Shift+S")
    save_as_file.setIcon(QIcon("sa.png"))
    save_as_file.triggered.connect(partial(save_as_file_func, mw, content_edit))

    save_file = QAction("Save", mw)
    save_file.setShortcut("Ctrl+S")
    save_file.setIcon(mw.style().standardIcon(QStyle.SP_DialogSaveButton))
    save_file.triggered.connect(partial(save_file_func, mw, content_edit))

    exit_app = QAction("Exit", mw)
    exit_app.setShortcut("Ctrl+Q")
    exit_app.setIcon(mw.style().standardIcon(QStyle.SP_DialogCloseButton))
    exit_app.triggered.connect(lambda checked: mw.close())

    file_menu.addAction(open_file)
    file_menu.addAction(save_file)
    file_menu.addAction(save_as_file)
    file_menu.addSeparator()
    file_menu.addAction(exit_app)

    tb.addAction(open_file)
    tb.addAction(save_file)
    tb.addAction(save_as_file)
    tb.addAction(exit_app)

    mw.setWindowTitle("File Open Dialog")
    mw.resize(800, 600)
    mw.setWindowIcon(QIcon("icon.png"))
    mw.show()

    sys.exit(app.exec_())

这个示例实现了一个非常简单的文本编辑器。打开文件、存储文件、另存文件都实现为QAction，这个可以在菜单和工具栏上复用，还是非常方便的。

程序界面

当文件被编辑时，标题中增加*，便于保存和另存。PyQt5很好很强大啊。当然如果需要一次打开多个文件，那么这里可能需要实现一个MDIArea，这个就不是本文的重点了。

这个程序用到functools.partial，很好的帮助我们在设置QAction的triggered信号时传递参数。如果使用lambda，可能不便于捕捉参数的当地值。

程序的图标使用了部分PyQt5的标准图标，标准图标的名称用SP_xxxx从QStyle中获得。

内置图标

程序本身的图标准备了两个图片文件。

程序图标
另存图标

结论

  1. QFileDialg是一个非常方便的文件选择对话框，可以用来打开文件、保存文件、选择文件夹等。
  2. QFileDialog的静态方法可以直接使用，也可以创建一个实例来使用。
  3. QFileDialog的静态方法返回的是一个元组，第一个元素是文件名，第二个元素是文件类型。

后记

当然，作为一个程序员，我对前面那个弱智玩意有很多不满意的地方，没办法，只好增加了代码语法高亮、行号、当前行高亮。

这亿点点细节就只有下次再写。
一点点细节

大福是小强
关注
  • 3
    点赞
  • 踩
  • 6
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
pyqt5 Python 桌面应用程序源码 带数据库
11-16
在本项目中，我们主要关注的是使用Python的PyQt5库构建桌面应用程序，并与数据库进行交互。PyQt5是Python中的一个图形用户界面（GUI）工具包，它提供了丰富的组件和功能来创建复杂的桌面应用。以下是对每个文件及...
pyqt5快速开发与实战源码
05-29
在Python中使用PyQt5进行桌面应用开发，你将接触到以下核心概念： 1. **Widgets（组件）**：PyQt5提供了一系列的Widget类，如按钮（QPushButton）、标签（QLabel）、文本框（QLineEdit）、对话框（QDialog）等，...
PyQt5——QFileDialog 打开文件对话框
知来者逆的博客
03-29 1492
这是演示了如何使用python和pyqt5实现打开文件对话框的详细教程
PyQt5 框架搭建+实战(多窗口打开,文件对话框)
qingjiao_fa的博客
01-18 3801
PyQt5 框架搭建+实战(多窗口打开,文件对话框)
PyQt5 的对话框
xy_optics的博客
05-11 689
PyQt5中的对话框是一种常见的用户界面组件，用于与用户进行交互并获取用户输入或确认。常见的对话框包括消息框、输入框、文件对话框、颜色对话框等。PyQt5提供了丰富的对话框类，可以满足各种不同的需求。QMessageBox（消息框）：用于显示消息、警告、错误等信息，并可以包含按钮供用户进行选择。QInputDialog（输入对话框）：用于获取用户输入，包括文本输入、整数输入、浮点数输入等。QFileDialog（文件对话框）：用于打开或保存文件，以及选择文件或文件夹。
PyQt5之QFileDialog文件对话框的使用
清風明月_xf 的博客
01-11 2078
PyQt5之QFileDialog文件对话框的使用
四、PyQt对话框的使用
ungoing的博客
10-06 3428
PyQt学习——对话框的使用
PyQt5桌面开发简易教程
03-26
PyQt5提供了多种预定义的对话框，如消息对话框（QMessageBox）、文件对话框（QFileDialog）和颜色选择对话框（QColorDialog）。 6. 事件和信号：4_PyQt5-Chinese-tutoral_事件和信号.pdf 事件和信号是PyQt5中事件...
PyQt5快速开发与实战.zip
05-16
PyQt5是Python编程语言与Qt库的接口，它允许开发者使用Python的简洁语法和Qt的强大功能进行桌面应用开发。这本书“PyQt5快速开发与实战”无疑为想要掌握这一技术的初学者和进阶者提供了宝贵的资源。下面将详细阐述...
python GUI库图形界面开发之PyQt5开发环境配置与基础使用
12-20
**Python GUI库图形界面开发之PyQt5** ...通过掌握这些基础知识，你可以开始利用PyQt5开发复杂的图形用户界面应用。在进一步学习过程中，可以查阅上述列出的相关文章，了解更具体的控件使用方法和高级功能。
PyQt5 打开对话框 选择文件或文件夹
q610098308的专栏
03-05 4902
【代码】PyQt5 打开对话框 选择文件或文件夹。
PyQt5文件对话框
qq_41122834的博客
05-25 320
import sys from PyQt5.QtWidgets import * from PyQt5.QtCore import * from PyQt5.QtGui import * class QFileDialogDemo(QWidget): def __init__(self): super(QFileDialogDemo,self).__init__() self.initUI() def initUI(self): layo
062.PyQt5_QFileDialog_文件选择对话框
weixin_50296259的博客
05-14 1708
PyQt5_QFileDialog_文件选择对话框 提供了一个对话框，允许用户选择文件或目录 允许用户遍历文件系统，以选择一个或多个文件或目录
实验室项目展示用PyQt系列（6）打开文件框的使用以及PyQt的踩坑与注意事项
pyc0551的博客
06-21 468
出现这一问题的可能原因是，这一进程创建了一个plt的进程，或者是QGridLayout的显示属于新创建的另一进程，不属于界面主程序的进程之内，解决这一问题摸索到两种解决方法。需要注意的是，这一函数能够改善用户体验，但若用户过于心急，在函数未能运行完成就点击其他按钮，仍然可能导致报错，因此，仍有必要通过系列（5）所述或其他方法增加程序运行稳定性。对于较为简单的单线进行操作的界面，一个较为方便的方法是设置一个类内初始化为0的参数，每按照步骤进行一次操作即+1，若在未进行到该步骤的情况下进行某些操作即该参数。
实战PyQt5: 057-文件对话框QFileDialog
seniorwizard的专栏
11-20 4038
QFileDialog简介 在前面的文章中，在保存和打开文件的时候，我们已经多次使用了QFileDialog,本文对QFileDialog相关功能做一详叙述。 QFileDialog控件提供了允许用户选择文件或者目录的对话框。它继承自QDialog, QFileDialog允许用户在文件系统上遍历来选择一个或多个文件或目录。QFileDialog在打开文件时可以使用文件过滤器，用于显示指定扩展名类型的文件，它也可以设置使用QFileDialog打开文件时的起始目录。 使用QFileDialog最简单的
PyQt5 教程 《对话框》
pansaky的博客
08-08 918
目录 PyQt5中的对话框 QInputDialog QColorDialog QFontDialog QFileDialog PyQt5中的对话框 对话框窗口或对话框是大多数现代GUI应用程序中不可或缺的一部分。对话框被定义为两个或更多人之间的对话。在计算机应用程序中，对话框是用于与应用程序“对话”的窗口。对话框用于输入数据，修改数据，更改应用程序设置等。 QInpu...
PyQt之打开保存对话框(QFileDialog)的方法和使用
lb0737的博客
11-21 7826
PyQt之打开保存对话框(QFileDialog)的方法和使用 一、控件说明 QFileDialog是用于打开和保存文件的标准对话框，继承自QDialog类。 QFileDialog在打开文件时使用了文件过滤器，用于显示指定扩展名的文件，也可以设置使用QFileDialog打开文件时的起始文件路径和指定扩展名。 二、QFileDialog类的常用方法 getOpenFileName(): 返...
QT--线程
m0_51830537的博客
07-24 1108
【代码】QT--线程。
ubuntu cmake使用自己版本的qt
最新发布
南北粉面馆
07-25 152
【代码】ubuntu cmake使用自己版本的qt。
pyqt5 打开文件对话框
03-15
它提供了丰富的功能和工具，可以用于开发跨平台的桌面应用程序。在PyQt5中，可以使用QFileDialog类来创建打开文件对话框。 要使用QFileDialog类创建打开文件对话框，可以按照以下步骤进行操作： 1 导入必要的模块...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

大福是小强

除非你钱多烧得慌……

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值