PyQt5如何创建不被其他模态对话框阻塞的独立非模态对话框

我尝试扩展非模态对话框的解决方案，现有代码如下：

from PyQt5 import QtWidgets
dialog = None


class Dialog(QtWidgets.QDialog):
    def __init__(self, *args, **kwargs):
        super(Dialog, self).__init__(*args, **kwargs)
        self.setWindowTitle('A floating dialog')
        self.resize(250,250)


class Window(QtWidgets.QWidget):
    def __init__(self):
        QtWidgets.QWidget.__init__(self)
        button = QtWidgets.QPushButton('Open Dialog', self)
        button.clicked.connect(self.handleOpenDialog)
        self.resize(300, 200)
        self._dialog = None
        global dialog
        dialog = Dialog(self)
        dialog.show()

    def handleOpenDialog(self):
        if self._dialog is None:
            self._dialog = QtWidgets.QDialog(self)
            self._dialog.resize(200, 100)
        self._dialog.exec_()


if __name__ == '__main__':

    import sys
    app = QtWidgets.QApplication(sys.argv)
    win = Window()
    win.show()
    sys.exit(app.exec_())

我需要实现一个独立于所有现有窗口/对话框的非模态窗口/对话框，始终支持正常交互，即应用窗口或任意其他对话框的GUI循环不会阻塞该非模态对话框。为简化演示，我在上述代码片段中使用全局变量dialog存储该非模态对话框的实例。

运行上述代码时，主窗口和非模态对话框会同时显示，二者均支持用户交互，但点击按钮后，self._dialog的GUI循环启动，用户将无法再与悬浮对话框、应用主窗口交互。我想要实现的效果是：此时仍然可以与dialog交互，但无法与主窗口Window交互。

我想要实现的效果和下方示例类似：

我从主窗口打开帮助对话框，再打开一个非模态对话框显示在主窗口上方，此时无法与主窗口交互，但不会阻塞帮助对话框，仍然允许用户与该帮助对话框交互，即本示例中帮助对话框的效果。

根因分析 #

你用到的QDialog.exec_()方法默认会启动应用级模态事件循环，会直接阻塞整个应用内所有顶级窗口的交互，这是导致全局悬浮对话框也无法操作的核心原因。

修改思路 #

• 取消全局悬浮对话框和主窗口的父子关系，避免主窗口状态变化连带影响悬浮对话框
• 弹出需要阻塞主窗口的对话框时，不用exec_()方法，改用show()配合手动禁用主窗口实现窗口级阻塞
• 给临时弹出的对话框绑定关闭信号，关闭时自动恢复主窗口的交互能力

完整修改后代码 #

from PyQt5 import QtWidgets, QtCore
dialog = None


class Dialog(QtWidgets.QDialog):
    def __init__(self, *args, **kwargs):
        super(Dialog, self).__init__(*args, **kwargs)
        # 明确设置窗口flag，确保是独立顶级窗口
        self.setWindowFlags(self.windowFlags() | QtCore.Qt.Window)
        self.setWindowTitle('悬浮对话框')
        self.resize(250,250)


class Window(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        button = QtWidgets.QPushButton('打开对话框', self)
        button.clicked.connect(self.handleOpenDialog)
        self.resize(300, 200)
        self._dialog = None
        global dialog
        # 不给悬浮对话框设置父级，完全独立
        dialog = Dialog()
        dialog.show()

    def handleOpenDialog(self):
        if self._dialog is None:
            self._dialog = QtWidgets.QDialog(self)
            self._dialog.resize(200, 100)
            self._dialog.setWindowTitle('仅阻塞主窗口的对话框')
            # 对话框关闭时恢复主窗口可用
            self._dialog.finished.connect(self.on_dialog_closed)
        # 禁用主窗口
        self.setDisabled(True)
        # 不用exec_，改用show
        self._dialog.show()

    def on_dialog_closed(self):
        # 恢复主窗口交互
        self.setDisabled(False)


if __name__ == '__main__':
    import sys
    app = QtWidgets.QApplication(sys.argv)
    win = Window()
    win.show()
    sys.exit(app.exec_())

效果说明 #

运行修改后的代码，点击按钮弹出对话框时，主窗口会被禁用无法交互，但全局悬浮的对话框始终可以正常操作，完全符合你的需求。

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