使用新建文件对话框时二级窗口被主窗口遮挡的问题求助

问题描述 #

我有一个普通主窗口（未设置置顶属性），通过菜单选项可打开一个普通二级窗口，二级窗口内的按钮用于触发文件对话框以获取文件名。当前存在两个矛盾问题：

• 打开文件对话框时，二级窗口会被主窗口遮挡；
• 若给二级窗口设置Qt.WindowStaysOnTopHint置顶属性，它又会遮挡弹出的文件对话框。

开发环境：Python 3.10、PyQt5、Windows 11，可复现问题的简化代码如下：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton, QWidget, QVBoxLayout, QFileDialog, QLabel

app = QApplication(sys.argv)
app.setStyle('Fusion')

class SecondWindow(QWidget):
   def __init__(self):
      super().__init__()
      self.a_button = QPushButton('Press for file dialog')
      mylabel = QLabel("I'll be hidden behind main window")
      layout = QVBoxLayout()
      layout.addWidget(self.a_button)
      layout.addWidget(mylabel)
      self.setLayout(layout)
      # self.setWindowFlags(self.windowFlags() | Qt.WindowStaysOnTopHint)

class MainWindow(QMainWindow):
   def __init__(self):
      super().__init__()

      button = QPushButton("Open")
      button.clicked.connect(self.my_window)
      self.setCentralWidget(button)

      self.win2 = SecondWindow()
      self.win2.a_button.clicked.connect(self.open_select)

   def open_select(self):
      options = QFileDialog.Options()
      # options |= QtWidgets.QFileDialog.DontUseNativeDialog
      fileName, _ = QFileDialog.getSaveFileName(self,
                                                          "New",
                                                          "",
                                                          "QText(*.qtext)",
                                                          options=options)
      if not fileName:
         return

   def my_window(self):
      if self.win2.isVisible():
         self.win2.hide()
      else:
         self.win2.show()

mainWin = MainWindow()
mainWin.show()
sys.exit(app.exec_())

问题原因 #

核心问题在于窗口父子关系未明确，且文件对话框的父窗口指定错误：

1. 二级窗口与主窗口为同级独立窗口，无父子关联，导致文件对话框以主窗口为父弹出时，系统会将主窗口前置，遮挡二级窗口；
2. 若强制二级窗口置顶，其层级会高于主窗口和文件对话框，进而遮挡对话框。

解决方案 #

通过明确窗口父子关系和正确指定文件对话框的父窗口，即可解决两种遮挡问题：

1. 创建二级窗口时，将主窗口作为父窗口传入，让二级窗口成为主窗口的子窗口，继承父窗口的层级上下文；
2. 调用文件对话框时，将二级窗口作为父窗口，确保对话框层级依附于二级窗口。

修改后的代码如下：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton, QWidget, QVBoxLayout, QFileDialog, QLabel
from PyQt5.QtCore import Qt

app = QApplication(sys.argv)
app.setStyle('Fusion')

class SecondWindow(QWidget):
   def __init__(self, parent=None):
      super().__init__(parent)  # 绑定父窗口
      self.a_button = QPushButton('Press for file dialog')
      mylabel = QLabel("No longer hidden behind main window")
      layout = QVBoxLayout()
      layout.addWidget(self.a_button)
      layout.addWidget(mylabel)
      self.setLayout(layout)
      # 无需设置置顶属性

class MainWindow(QMainWindow):
   def __init__(self):
      super().__init__()

      button = QPushButton("Open")
      button.clicked.connect(self.my_window)
      self.setCentralWidget(button)

      self.win2 = SecondWindow(self)  # 指定主窗口为二级窗口的父
      self.win2.a_button.clicked.connect(self.open_select)

   def open_select(self):
      options = QFileDialog.Options()
      fileName, _ = QFileDialog.getSaveFileName(
          self.win2,  # 将二级窗口设为文件对话框的父窗口
          "New",
          "",
          "QText(*.qtext)",
          options=options
      )
      if not fileName:
         return

   def my_window(self):
      if self.win2.isVisible():
         self.win2.hide()
      else:
         self.win2.show()

mainWin = MainWindow()
mainWin.show()
sys.exit(app.exec_())

效果说明 #

• 二级窗口作为主窗口的子窗口，不会被主窗口遮挡；
• 文件对话框以二级窗口为父弹出，会显示在二级窗口之上，同时二级窗口保持在主窗口之上，解决了两种遮挡矛盾。

内容的提问来源于stack exchange，提问作者Eduardo C.