GUI学习之二十九—QFileDialog学习总结

今天学习的是文件对话框——QFileDialog

一.描述

　　QFileDialog提供了一个对话框，允许用户选择文件或者目录，也允许用户遍历文件系统，用以选择一个或多个文件或者目录。

　　QFileDialog继承了QDialog，具有父类的各种方法。

二.功能作用

　　1.最简单的获取方法(静态方法)

　　获取文件

QFileDialog.getOpenFileName()    #获取一个打开文件的文件名
QFileDialog.getOpenFileNames()   #获取多个打开文件的文件名
QFileDialog.getOpenFileUrl()     #获取一个打开文件的统一资源定位符
QFileDialog.getOpenFileUrls()    #获取多个打开文件的统一资源定位符
QFileDialog.getSaveFileName()    #获取保存的文件名
QFileDialog.getSaveFileUrl()     #获取保存的url

　　这些代码使用的方法基本一样，我们来演示一下

fd = QFileDialog.getOpenFileName(self,'选择一个py文件','./','ALL(*.*);;Images(*.png *.jpg);;Python文件(*.py)','Python文件(*.py)')
print(fd)

　　下面介绍一下每个参数的意义：

　　self就不用说了，第一个‘选择一个py文件’是对话框的标题

　　'./'是打开对话框的默认地址

　　'ALL(*.*);;Images(*.png *.jpg);;Python文件(*.py)'是过滤字符串，定义了打开按钮上面的下拉框里的内容(文件类型)，注意不同的文件类型之间是用两个分号隔开的。

　　'Python文件(*.py)'最后这个参数是初始的过滤值，就是对话框弹出时过滤出的文件类型。

　　最后运行的结果打印出了一个元组

('D:/python/PyQt_GUI/QFileDialog/1.py', 'Python文件(*.py)')

　　我们可以根据需求进行操作（元组的第2个元素是选择时候的过滤字符串）

　　用选择多个文件getOpenFileNames()的方法时，返回的元组的第一个元素是个列表，列表里的内容就是选择的文件。url地址的用法是一样的。但返回的元组的第一个元素是个PyQt5.QtCore.QUrl，我们可以直接拿来使用。

　　获取保存的文件名里的参数和获取打开文件名是一样的，不过弹框的效果不太一样

原先的过滤字符串编程了保存类型。但返回的值还是一样的。

　　获取文件夹

QFileDialog.getExistingDirectory()
QFileDialog.getExistingDirectoryUrl()

　　获取文件夹的参数比较简单，只需给定路径就可以（标题是可有可无的！）并且返回值直接就是个字符串（文件夹的路径）

　　但是获取文件夹Url的方法就有些区别，路径不能是一个简单的申明路径的字符串，而必须是个QUrl，并且标题也是必须要有的，返回值也是个QUrl对象。

fd = QFileDialog.getExistingDirectoryUrl(self,'选择一个文件夹',QUrl('./.'))

　　最后不从一下过滤字符串的格式

名称1(*.jpg *.png);;名称2(*.py)

　　比如名称1有两种以上格式的文件(jpg,png)就可以直接列出来以后用空格来分割，而名称1和名称2之间是需要两个分号来分割。

　　2.构造函数

　　大部分的场景用上面的静态方法都够用了，这里我们可以通过构造函数来使用。

from PyQt5.Qt import *
import sys

class Window(QWidget):
    def __init__(self):
        super().__init__()
        self.UI_test()

    def UI_test(self):
        btn = QPushButton('test',self)
        btn.clicked.connect(self.fun)

    def fun(self):
        fd = QFileDialog(self,'选择文件','../')
        fd.open()
        print('test')    #运行代码可以通过这行代码发现对话框是个非阻塞的，如果想获得选择的文件就需要借助下面的信号
        fd.fileSelected.connect(lambda file:print(file))

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

　　这里只讲了最基础的用法，后面可以结合一些方法来表现出不同的效果。

　　3.接收模式

　　因为QFileDialog分为打开和保存两种模式，默认情况是打开文件的。但是我们也可以通过下面的代码把他设置成为保存模式的。

QFileDialog.setAcceptMode(self, mode: 'QFileDialog.AcceptMode')
AcceptOpen = ...  # type: 'QFileDialog.AcceptMode'
AcceptSave = ...  # type: 'QFileDialog.AcceptMode'

　　4.默认后缀

　　如果我们希望文件名称是带有默认后缀的，可以用下面的方法

QFileDialog.setDefaultSuffix(self, suffix: str)

　　在显示效果里是文件名后是没有后缀的，但是返回的参数就加上了后缀名。

　　5.设置文件模式(文件/文件夹)

　　通过下面的方法可以设置要操作的对象是文件还是文件夹

QFileDialog.setFileMode(self, mode: 'QFileDialog.FileMode')
#QFileDialog.FileMode中FileMode枚举值
# AnyFile   任意文件，无论是否存在
# ExistingFile  已存在的文件
# Directory     文件夹
# ExistingFiles  0个或多个现有文件
# DirectoryOnly  只能为目录

　　6.设置名称过滤器

QFileDialog.setNameFilters(self, filters: typing.Iterable[str])
QFileDialog.setNameFilter(self, filter: str)

　　注意如果是多个过滤器是迭代器的用法，用列表或元组就可以了，就可以不用前面说的用两个分号来分割。还有如果如果在构造函数里定义了过滤器，这里也设置了，那么是按这个过滤器来设置的。

　　7.信息显示的详细程度

QFileDialog.setViewMode(self, mode: 'QFileDialog.ViewMode')
Detail = ...  # type: 'QFileDialog.ViewMode'
List = ...  # type: 'QFileDialog.ViewMode'

　　但是这个设置在win10里是没有效果的，通过对话框里的显示图标就可以改了，可能后续的版本会改进吧。

　　8.指定的角色标签名称

　　我们可以对文件名、文件类型等标签的文本进行设置

QFileDialog.setLabelText(self, label: 'QFileDialog.DialogLabel', text: str)
# LookIn = ...  # type: 'QFileDialog.DialogLabel'
# FileName = ...  # type: 'QFileDialog.DialogLabel'
# FileType = ...  # type: 'QFileDialog.DialogLabel'
# Accept = ...  # type: 'QFileDialog.DialogLabel'
# Reject = ...  # type: 'QFileDialog.DialogLabel'

　　9.打开对话框

　　打开对话框除了前面用的open()以外，还可以通过由返回值的exec()来使用（和父类QDialog的返回方法是一样的）

三。常用信号

QFileDialog.currentChanged(self, path: str)                     #当前发生变化（参数为路径字符串）
QFileDialog.currentUrlChanged(self, url: QtCore.QUrl)           #当前发生变化（参数为Url）
QFileDialog.directoryEntered(self, directory: str)              #进入目录（参数为路径字符串）
QFileDialog.directoryUrlEntered(self, directory: QtCore.QUrl)   #进入目录（参数为Url）
QFileDialog.filterSelected(self, filter: str)                   #名称字符串过滤器变化（参数为过滤器对应字符串）
QFileDialog.fileSelected(self, file: str)
QFileDialog.filesSelected(self, files: typing.Iterable[str])
QFileDialog.urlSelected(self, url: QtCore.QUrl)
QFileDialog.urlsSelected(self, urls: typing.Iterable[QtCore.QUrl])

注意一下，1.当前发生变化是只要鼠标点中文件或文件夹就触发，而进入目录是必须进入到文件夹里才触发。