PyQt5子类化QFontDialog时如何正确获取选中字体属性？

核心错误点 #

• API调用混淆：QFontDialog.getFont()是Qt提供的静态工具方法，作用是快速弹出一个独立的模态字体选择窗口，本身就会创建新的对话框实例。在你已经实例化的自定义子类内部调用这个方法，必然会额外弹出一个无关联的独立窗口，和当前嵌入的对话框没有任何状态同步。
• 冗余且兼容性差的信号绑定：通过遍历子控件、匹配OK按钮文本的方式绑定确认逻辑，很容易因为系统语言、按钮顺序变化失效，QFontDialog本身内置了accepted()信号，用户点击确认按钮时会自动触发，不需要手动查找按钮、断开原有连接。
• 冗余触发逻辑：主窗口初始化时无父类创建了第二个FontSelection实例，还主动调用字体捕获方法，导致程序刚启动就触发弹窗流程。
• 取值方式错误：要获取当前嵌入的QFontDialog实例的选中字体，不需要调用静态getFont()，直接用实例方法即可：
  • selectedFont()：用户点击确认后，返回最终选中的有效字体
  • currentFont()：实时返回界面上当前高亮选中的字体，不需要等用户确认
  • currentFontChanged信号：用户调整字体选择时会实时触发，同步返回最新的字体对象

调整后的可运行代码 #

from PyQt5.QtWidgets import (QFontDialog, QPushButton, 
                            QMainWindow, QApplication, 
                            QTabWidget, QWidget, QVBoxLayout)

import sys

class FontSelection(QFontDialog) :
    def __init__(self, parent=None):
        super(FontSelection, self).__init__(parent)
        # 强制使用非原生对话框，确保可以正常嵌入到其他控件树中
        self.setOption(self.DontUseNativeDialog, True)
        # 绑定内置确认信号，替代手动查找OK按钮的逻辑
        self.accepted.connect(self.capture_selected_font)
        # 可选：绑定实时字体变化信号，无需等待用户确认即可获取当前选中值
        self.currentFontChanged.connect(self.on_font_preview)
        # 初始化存储选中字体的属性
        self.current_selected_font = None

    def capture_selected_font(self):
        # 直接从当前实例获取最终选中的字体，禁止调用静态getFont()
        self.current_selected_font = self.selectedFont()
        print(f"用户确认选中的字体：{self.current_selected_font.family()}，字号：{self.current_selected_font.pointSize()}")

    def on_font_preview(self, font):
        # 实时同步预览选中的字体
        print(f"当前预览字体：{font.family()}")


class MainQFontDialogTry(QMainWindow):
    def __init__(self):
        super(MainQFontDialogTry, self).__init__()
    
        self.setWindowTitle('QFontDialog subclassed try')
        self.setGeometry(0, 0, 1000, 760)
        self.setMinimumSize(1000, 760)
    
        self.tab_widget = QTabWidget()
        # 将自定义的字体对话框直接作为Tab页嵌入
        self.font_dialog_tab = FontSelection(self)

        central_widget = QWidget()
        layout = QVBoxLayout(central_widget)
        self.tab_widget.addTab(self.font_dialog_tab, "QFontDialog Tab")
        layout.addWidget(self.tab_widget)
        self.setCentralWidget(central_widget)
        # 删除原代码中多余的实例化和主动触发逻辑，避免启动流程异常

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

补充说明 #

• 如果你需要把这个自定义字体对话框作为独立模态窗口弹出，只需要在对应触发位置调用self.font_dialog_tab.exec()即可，不需要额外创建新实例。
• 原生对话框是系统级实现，无法嵌入到Qt控件树中，必须设置DontUseNativeDialog选项才能将其作为普通子控件使用。
• 静态方法getFont()和自定义子类是完全独立的两套逻辑，不要在子类内部混用，否则会出现额外弹窗的问题。

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