PyQt6子窗口在MacOS Ventura无标题栏及关闭按钮问题求助

在MacOS Ventura 13.4.1环境下，PyQt6子窗口因设置Tool窗口标志实现置顶，导致丢失标题栏和标准控制按钮（如关闭按钮）——这是因为Qt在MacOS与Windows平台对Tool标志的渲染逻辑存在差异。

方案一：替换Tool标志为WindowStaysOnTopHint（推荐） #

Tool窗口在MacOS中默认是无装饰的轻量级窗口，若仅需实现"置顶父窗口"的需求，改用WindowStaysOnTopHint标志可保留标准窗口装饰，同时满足置顶要求。

修改调用子窗口的代码如下：

def on_image_area_picker_triggered(self):
    """
    Callback for the user pressing the area selection toolbar action. Opens the area selection
    user interface.
    """
    self.area_window = AreaSelectionWindow(self.calculation_area, self)
    self.area_window.setWindowFlag(QtCore.Qt.WindowType.Window, True) # 保持独立窗口属性
    # 替换Tool标志为WindowStaysOnTopHint，实现置顶且保留标题栏
    self.area_window.setWindowFlag(QtCore.Qt.WindowType.WindowStaysOnTopHint, True)
    self.area_window.setWindowModality(QtCore.Qt.WindowModality.WindowModal) # 保持模态聚焦
    self.area_window.resize(500, 400)
    self.area_window.show()
    self.area_window.new_area.connect(self.on_area_window_new_area)
    self.area_window.clear_area.connect(self.on_area_window_new_area)

方案二：强制为Tool窗口添加装饰（兼容性有限） #

若必须保留Tool窗口属性，可尝试强制启用标题栏和关闭按钮的显示，但该方案在MacOS上的效果可能因系统版本或Qt版本存在差异：

在子窗口的__init__方法中添加如下代码：

def __init__(self, area_data: np.ndarray[np.float64]|None, parent: QtWidgets.QWidget|None):
    super().__init__(parent)
    self.setWindowTitle(self.tr("Area selection"))
    # 强制添加标题栏和关闭按钮
    self.setWindowFlags(self.windowFlags() | QtCore.Qt.WindowTitleHint | QtCore.Qt.WindowCloseButtonHint)

或在调用子窗口时设置：

self.area_window.setWindowFlag(QtCore.Qt.WindowType.Tool, True)
# 启用标题栏和关闭按钮
self.area_window.setWindowFlag(QtCore.Qt.WindowType.WindowTitleHint, True)
self.area_window.setWindowFlag(QtCore.Qt.WindowType.WindowCloseButtonHint, True)

原理说明 #

MacOS的窗口管理框架对Tool类型窗口的定义与Windows不同：Windows下Tool窗口保留标准装饰，而MacOS将其设计为无标题栏的辅助窗口。使用WindowStaysOnTopHint是更符合Mac平台规范的置顶实现方式，既能满足功能需求，又能保持系统原生窗口样式。

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