如何在QDockWidget浮动时为主窗口显示其内部控件的状态提示？

问题根源 #

QDockWidget切换为浮动状态时，会生成独立的顶级窗口容器，此时内部控件触发的QStatusTipEvent会默认发送给这个浮动窗口而非主窗口——但浮动窗口本身没有状态栏，导致状态提示无法正常显示。

解决方案：事件过滤器转发 #

通过给QDockWidget安装事件过滤器，拦截内部控件的状态提示事件，手动将其转发到主窗口的状态栏，无需逐个控件手动管理状态提示逻辑。

代码示例（PyQt/PySide） #

from PyQt5.QtWidgets import QMainWindow, QDockWidget, QPushButton, QApplication
from PyQt5.QtCore import QEvent, QObject

class DockStatusTipFix(QObject):
    def __init__(self, main_window):
        super().__init__()
        self.main_window = main_window

    def eventFilter(self, obj, event):
        # 捕获状态提示事件
        if event.type() == QEvent.StatusTip:
            # 将提示文本转发到主窗口状态栏
            self.main_window.statusBar().showMessage(event.tip())
            return True
        return super().eventFilter(obj, event)

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

    def init_ui(self):
        # 创建带按钮的QDockWidget
        dock = QDockWidget("测试停靠栏", self)
        test_btn = QPushButton("悬停查看提示")
        test_btn.setStatusTip("这是来自停靠栏按钮的状态提示")
        dock.setWidget(test_btn)
        self.addDockWidget(1, dock)

        # 给停靠栏安装事件过滤器
        status_fix = DockStatusTipFix(self)
        dock.installEventFilter(status_fix)

if __name__ == "__main__":
    app = QApplication([])
    window = MainWindow()
    window.show()
    app.exec_()

代码说明 #

1. 自定义DockStatusTipFix类作为事件过滤器，持有主窗口的引用。
2. 重写eventFilter方法，拦截QEvent.StatusTip类型的事件。
3. 触发事件时，直接调用主窗口状态栏的showMessage方法显示提示文本。
4. 给目标QDockWidget安装过滤器后，无论停靠还是浮动，内部控件的状态提示都会正常显示在主窗口状态栏。

多停靠栏场景：全局事件过滤器 #

如果有多个QDockWidget，可给QApplication安装全局事件过滤器，统一处理所有浮动停靠栏的状态提示：

class GlobalStatusTipFix(QObject):
    def __init__(self, main_window):
        super().__init__()
        self.main_window = main_window

    def eventFilter(self, obj, event):
        if event.type() == QEvent.StatusTip:
            # 向上遍历父控件，判断是否来自浮动的QDockWidget
            parent = obj.parent()
            while parent:
                if isinstance(parent, QDockWidget) and parent.isFloating():
                    self.main_window.statusBar().showMessage(event.tip())
                    return True
                parent = parent.parent()
        return super().eventFilter(obj, event)

# 在主窗口初始化中安装全局过滤器：
# app.installEventFilter(GlobalStatusTipFix(self))

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