咱们来一步步拆解这段代码，看看它如何创建带按钮的主窗口，以及核心的QFileDialog文件选择对话框是怎么配置和控制的。

一、代码整体结构概述 #

这段代码定义了一个继承自QMainWindow的App类，核心功能是创建一个带按钮的窗口，点击按钮会弹出Windows系统风格的文件选择对话框。

先看基础部分：

• 首先导入了PyQt4的GUI组件（QApplication、QMainWindow、QPushButton、QFileDialog等）和核心模块（pyqtSlot用于定义槽函数）。
• App类的__init__方法里设置了窗口的位置、大小和标题，然后调用initUI初始化界面元素。

二、界面初始化（initUI方法） #

在initUI里，代码创建了一个文本为...的按钮（通常这种按钮用来触发文件选择操作），并设置了它的位置。不过原代码没写完，咱们补全合理的逻辑：给按钮绑定点击事件的槽函数，这样点击按钮时就能调用文件对话框了。

三、QFileDialog的核心控制方式 #

这是这段代码的重点，QFileDialog是PyQt里用于文件/目录选择的核心组件，咱们从几个维度讲它的控制方式：

1. 调用系统原生对话框（Windows风格） #

QFileDialog默认会自动适配当前系统的风格，在Windows下会弹出原生的文件选择框。如果要明确控制是否使用原生对话框，可以通过options参数设置：

• 默认使用原生对话框：不需要额外设置，或者传QFileDialog.Options()
• 强制使用Qt自定义对话框：添加QFileDialog.DontUseNativeDialog选项

2. 常用的对话框类型 #

根据需求选择不同的静态方法调用：

• 选择单个文件：QFileDialog.getOpenFileName()
• 选择多个文件：QFileDialog.getOpenFileNames()
• 保存文件（会提示覆盖已存在文件）：QFileDialog.getSaveFileName()
• 选择文件夹：QFileDialog.getExistingDirectory()

3. 关键参数详解 #

以getOpenFileName为例，它的参数决定了对话框的行为：

• 父窗口：第一个参数传self（当前主窗口），这样对话框会依附于主窗口，关闭主窗口时对话框也会关闭，而且会显示在主窗口上方。
• 对话框标题：第二个参数，比如"选择要打开的文件"，用来提示用户操作目的。
• 默认打开路径：第三个参数，设置对话框启动时默认显示的文件夹，比如传"C:/Users"就会直接打开用户目录，空字符串则默认打开当前程序运行目录。
• 文件过滤器：第四个参数，用分号分隔不同的过滤规则，比如"图像文件 (*.png *.jpg);;PDF文件 (*.pdf)"，用户可以通过下拉菜单选择不同的过滤类型来筛选文件。
• 选项参数：控制对话框的特殊行为，比如：
  • QFileDialog.ShowDirsOnly：只显示文件夹，适合选择目录的场景
  • QFileDialog.ReadOnly：对话框以只读模式打开，用户无法修改文件
  • QFileDialog.DontConfirmOverwrite：保存文件时不提示覆盖已存在的文件

4. 获取用户选择的结果 #

调用getOpenFileName会返回两个值：

• 第一个是选中的文件路径（如果用户点击取消，返回空字符串）
• 第二个是用户选中的过滤器类型

我们可以在槽函数里处理这个结果，比如把路径显示到输入框里：

@pyqtSlot()
def show_file_dialog(self):
    file_path, selected_filter = QFileDialog.getOpenFileName(
        self,
        "选择文件",
        "",
        "所有文件 (*.*);;文本文件 (*.txt)"
    )
    if file_path:  # 判断用户是否选中了文件
        self.file_path_edit.setText(file_path)  # 把路径显示到输入框

四、完整可运行的代码示例 #

把原代码补全后，完整的可运行代码如下：

import sys
from PyQt4.QtGui import QApplication, QMainWindow, QPushButton, QLineEdit, QLabel, QComboBox, QProgressBar, QFileDialog
from PyQt4.QtCore import QSize, pyqtSlot, QCoreApplication

class App(QMainWindow):
    def __init__(self):
        super(App, self).__init__()
        self.setGeometry(500, 300, 820, 350)
        self.setWindowTitle("Program")
        self.initUI()

    def initUI(self):
        # 创建文件选择按钮
        btnposx = 30
        btnposy = 50
        self.btn1 = QPushButton('...', self)
        self.btn1.setGeometry(btnposx, btnposy, 50, 30)
        # 绑定点击事件到槽函数
        self.btn1.clicked.connect(self.show_file_dialog)

        # 创建输入框用于显示选中的文件路径
        self.file_path_edit = QLineEdit(self)
        self.file_path_edit.setGeometry(btnposx + 60, btnposy, 700, 30)

    @pyqtSlot()
    def show_file_dialog(self):
        # 弹出Windows风格的文件选择对话框
        file_path, _ = QFileDialog.getOpenFileName(
            self,
            "选择要打开的文件",
            "",
            "所有文件 (*.*);;文本文件 (*.txt)"
        )
        if file_path:
            self.file_path_edit.setText(file_path)

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

内容的提问来源于stack exchange，提问作者Artur Müller Romanov