PyQt5 QFileDialog 详解

PyQt5 QFileDialog 详解

QFileDialog 是 PyQt5 中用于显示文件和文件夹选择对话框的类。它提供了一种方便的方式，让用户在应用程序中选择文件、文件夹或多个文件。QFileDialog 类位于 QtWidgets 模块中。

下面是关于 QFileDialog 的一些详解：

1. 创建和显示对话框： 可以通过创建一个 QFileDialog 对象，然后使用 exec_() 方法来显示文件对话框。根据用户的选择，可以获得所选文件或文件夹的路径。
2. 设置文件模式： 通过 setFileMode() 方法，你可以设置文件对话框的模式，决定用户可以选择的项目类型。可用的模式包括 QFileDialog.AnyFile（任何文件）、QFileDialog.ExistingFile（现有文件）、QFileDialog.ExistingFiles（多个现有文件）、QFileDialog.Directory（文件夹路径）、QFileDialog.DirectoryOnly（仅文件夹路径）、QFileDialog.ExistingDirectory（现有文件夹路径）和QFileDialog.ExistingDirectories（多个现有文件夹路径）。
3. 设置文件过滤器： 你可以使用 setNameFilter() 方法来设置文件对话框的文件过滤器，以限制用户在对话框中看到的文件类型。过滤器可以根据文件的扩展名来指定，例如 "Image Files (*.png *.jpg)"。
4. 设置默认目录和文件： 你可以使用 setDirectory() 方法来设置对话框打开时的默认目录，使用 selectFile() 方法来设置默认选择的文件。
5. 获取用户选择： 在对话框被关闭后，可以使用 selectedFiles() 方法来获取用户选择的文件路径列表。对于文件夹选择，你可以使用 selectedUrl() 方法来获取用户选择的文件夹路径。
6. 对话框选项： 可以使用 setOptions() 方法来设置对话框的一些选项，例如 QFileDialog.ReadOnly（只读模式）和 QFileDialog.ShowDirsOnly（仅显示文件夹）等。

下面是一个简单的示例，展示如何使用 QFileDialog 来选择文件和文件夹：

from PyQt5.QtWidgets import QFileDialog, QApplication

app = QApplication([])

options = QFileDialog.Options()
options |= QFileDialog.ReadOnly

# 选择文件
file_dialog = QFileDialog()
file_dialog.setOptions(options)
file_path, _ = file_dialog.getOpenFileName(None, "Open File", "", "Text Files (*.txt);;All Files (*)")

if file_path:
    print(f"Selected file: {file_path}")

# 选择文件夹
file_dialog.setFileMode(QFileDialog.Directory)
dir_path = file_dialog.getExistingDirectory(None, "Select Directory")

if dir_path:
    print(f"Selected directory: {dir_path}")

app.exec_()

在这个示例中，展示了如何使用 QFileDialog 来选择文件和文件夹。通过设置不同的模式和选项，你可以根据需要自定义文件对话框的行为。

setFileMode

在 PyQt5 中，QFileDialog 的 FileMode 可用于设置文件对话框的模式，以指定用户可以选择的项目类型。以下是 QFileDialog 中可用的 FileMode 类型：

1. QFileDialog.AnyFile: 允许用户选择任何文件，包括现有文件和不存在的文件。
2. QFileDialog.ExistingFile: 只允许用户选择现有的文件。
3. QFileDialog.ExistingFiles: 允许用户选择多个现有文件。
4. QFileDialog.Directory: 允许用户选择文件夹路径。
5. QFileDialog.DirectoryOnly: 仅允许用户选择文件夹路径，不允许选择文件。
6. QFileDialog.ExistingDirectory: 只允许用户选择现有的文件夹路径。
7. QFileDialog.ExistingDirectories: 允许用户选择多个现有文件夹路径。

根据需求，可以选择适当的 FileMode 类型来设置文件对话框的行为。例如，如果希望用户选择一个或多个现有的文件，可以使用 QFileDialog.ExistingFiles。

如果希望用户选择一个现有的文件夹路径，可以使用 QFileDialog.ExistingDirectory。