PyQt6实现类似QFontComboBox的文件选择下拉框方法问询

Qt没有原生的"文件选择下拉框"组件，但可以通过两种简洁方式实现类似效果：

方案一：给QLineEdit添加尾随Action（推荐） #

利用QLineEdit.addAction()在输入框尾部添加带图标的动作，点击图标即可弹出文件选择对话框。修复后的可运行代码如下：

import os.path
import sys

from PyQt6.QtGui import QAction, QIcon, QKeySequence
from PyQt6.QtWidgets import QWidget, QHBoxLayout, QLineEdit, QFileDialog, QApplication


class MainWindow(QWidget):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.setWindowTitle('文件选择测试')

        # 创建文件选择动作
        self.file_select_action = QAction(QIcon.fromTheme("document-open"), '选择文件')
        self.file_select_action.setShortcuts(QKeySequence.StandardKey.Open)
        self.file_select_action.setStatusTip("选择已有文件")
        self.file_select_action.triggered.connect(self.on_file_select)

        layout = QHBoxLayout()
        self.setLayout(layout)

        # 绑定动作的输入框
        self.file_edit = QLineEdit(self)
        self.file_edit.setPlaceholderText('输入文件路径或点击右侧图标选择')
        # 将动作添加到输入框右侧
        self.file_edit.addAction(self.file_select_action, QLineEdit.ActionPosition.TrailingPosition)

        layout.addWidget(self.file_edit)
        self.show()

    def on_file_select(self):
        fp, _ = QFileDialog.getOpenFileName(
            parent=self,
            caption='选择文件',
            filter='Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)')
        if fp:
            self.file_edit.setText(fp)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    win = MainWindow()
    sys.exit(app.exec())

要点说明： #

• 动作支持标准快捷键，兼顾键盘操作效率
• 图标采用系统主题图标，风格统一
• 无需子类化，代码逻辑简洁易维护

方案二：子类化QLineEdit实现聚焦触发选择 #

通过重写focusInEvent，让输入框获得焦点时自动弹出文件选择对话框，适合点击输入框直接选择文件的场景。修复后的代码如下：

import os.path
import sys

from PyQt6.QtWidgets import QWidget, QHBoxLayout, QLineEdit, QFileDialog, QApplication


class FileSelectLineEdit(QLineEdit):
    def __init__(self, caption='选择文件', name_filter=None, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.caption = caption
        self.name_filter = name_filter or 'All files (*)'
        self.setPlaceholderText(caption)

    def focusInEvent(self, event):
        # 保留父类原有聚焦逻辑
        super().focusInEvent(event)
        # 弹出文件选择框，初始目录设为当前输入路径的父目录
        fp, _ = QFileDialog.getOpenFileName(
            parent=self,
            caption=self.caption,
            filter=self.name_filter,
            directory=os.path.dirname(self.text()) if self.text() else None
        )
        if fp:
            self.setText(fp)
            # 选择完成后清空焦点，避免重复触发
            self.clearFocus()


class MainWindow(QWidget):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.setWindowTitle('文件选择测试')

        layout = QHBoxLayout()
        self.setLayout(layout)

        # 使用自定义文件选择输入框
        self.file_edit = FileSelectLineEdit(
            caption='选择文件',
            name_filter='Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml);;Python files (*.py);;All files (*)'
        )

        layout.addWidget(self.file_edit)
        self.show()


if __name__ == '__main__':
    app = QApplication(sys.argv)
    win = MainWindow()
    sys.exit(app.exec())

要点说明： #

• 聚焦触发选择，操作流程更贴合下拉框的使用习惯
• 支持自定义对话框标题和文件过滤规则
• 自动记忆上次选择的目录，提升用户体验

原问题背景 #

最初使用的是"QLineEdit + QPushButton"的标准文件选择方案：

import sys
from PyQt6.QtWidgets import QWidget, QHBoxLayout, QLineEdit, QPushButton, QFileDialog, QApplication


class MainWindow(QWidget):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.setWindowTitle('Test')

        layout = QHBoxLayout()
        self.setLayout(layout)

        self.file = QLineEdit(self)
        self.file.setPlaceholderText('Enter your file')

        self.btn = QPushButton('Select')
        self.btn.clicked.connect(self.on_btn_clicked)

        layout.addWidget(self.file)
        layout.addWidget(self.btn)

        self.show()

    def on_btn_clicked(self):
        fp = QFileDialog.getOpenFileName(
            parent=self,
            caption='Select file',
            filter='Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)')
        if fp:
            self.file.setText(fp[0])


if __name__ == '__main__':
    app = QApplication(sys.argv)
    win = MainWindow()
    sys.exit(app.exec())

用户希望实现类似QFontComboBox的一体化下拉选择体验，无需额外独立按钮，最终通过上述两种方案解决需求。

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