如何为PySide2的QDialog添加最小化按钮且无不良副作用？

核心问题在于你之前的窗口标志设置错误：要么丢失了Qt.Dialog核心标志导致层级关联失效，要么过度添加全局置顶标志破坏了原有行为。正确的做法是保留Qt.Dialog标志的同时，补充必要的按钮和窗口样式标志，具体实现如下：

正确代码示例 #

from PySide2 import QtCore, QtWidgets

class TestDialog(QtWidgets.QDialog):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.resize(200, 100)
        # 组合核心标志与所需按钮/样式
        self.setWindowFlags(
            QtCore.Qt.Dialog |
            QtCore.Qt.WindowTitleHint |
            QtCore.Qt.WindowSystemMenuHint |
            QtCore.Qt.WindowMinimizeButtonHint |
            QtCore.Qt.WindowCloseButtonHint
        )
        # 显式设置非模态（默认已开启，可省略）
        self.setModal(False)

if __name__ == "__main__":
    app = QtWidgets.QApplication([])
    # 创建主窗口作为对话框父级，确保层级绑定
    main_window = QtWidgets.QMainWindow()
    main_window.setWindowTitle("主应用窗口")
    main_window.resize(400, 300)
    main_window.show()
    
    dialog = TestDialog(parent=main_window)
    dialog.setWindowTitle("带最小化按钮的对话框")
    dialog.show()
    
    app.exec_()

代码说明 #

• Qt.Dialog：这是保证原有行为的核心标志，让对话框与父窗口保持层级关联——应用内始终位于其他控件上方，被其他应用窗口覆盖时自动隐藏。
• WindowTitleHint + WindowSystemMenuHint：提供标题栏和系统菜单支持，是显示最小化按钮的必要前提（部分平台如Windows强制要求）。
• WindowMinimizeButtonHint + WindowCloseButtonHint：显式添加最小化和关闭按钮。
• 指定父窗口：确保对话框与主应用窗口绑定，避免成为独立的顶级窗口。

错误尝试分析 #

1. 仅添加WindowMinimizeButtonHint：部分平台要求对话框同时具备系统菜单和标题栏标志才会显示最小化按钮，单独添加无效。
2. 直接替换为按钮标志：丢失了Qt.Dialog标志，对话框变成普通顶级窗口，失去与父窗口的层级关联，因此点击应用内其他区域会被隐藏。
3. 添加WindowStaysOnTopHint：强制对话框全局置顶，覆盖其他应用窗口，违背了需求。

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