Qt子控件事件未向父控件传播问题求助

为理解Qt事件处理机制，编写了一个PyQt6示例程序。根据文档及理解，为控件安装事件过滤器后，点击控件时事件会发送至关联的eventFilter；若不消耗事件（返回False），事件应向父控件传播。

但示例中，ChildWidget的eventFilter捕获MouseButtonPress事件后打印信息并返回False，事件并未传播至父控件MainWindow的eventFilter，求问题原因解析。

示例代码：

import sys
from PyQt6.QtWidgets import QApplication, QFrame, QVBoxLayout, QLabel, QPushButton
from PyQt6.QtCore import QEvent


class ChildWidget(QPushButton):
    def eventFilter(self, obj, event):
        if event.type() == QEvent.Type.MouseButtonPress:
            print("Mouse click event handled in the child widget")
            return False
        return super().eventFilter(obj, event)


class MainWindow(QFrame):
    def eventFilter(self, obj, event):
        if event.type() == QEvent.Type.MouseButtonPress:
            print("Mouse click event handled in the main window")
        return super().eventFilter(obj, event)


def main():
    app = QApplication(sys.argv)
    main_window = MainWindow()
    main_window.setWindowTitle("Event Propagation Example")
    main_window.setGeometry(100, 100, 300, 200)

    child_widget = ChildWidget("Click me! I'm the child widget")

    layout = QVBoxLayout()
    layout.addWidget(QLabel("Hello from the main window"))
    layout.addWidget(child_widget)

    main_window.setLayout(layout)

    child_widget.installEventFilter(child_widget)
    main_window.installEventFilter(main_window)

    main_window.show()
    sys.exit(app.exec())

if __name__ == "__main__":
    main()

1. 事件过滤器安装逻辑错误
   你给child_widget安装了自身作为事件过滤器，同时给main_window安装了自身作为过滤器。但父控件的过滤器不会自动监听子控件的事件——main_window.installEventFilter(main_window)只能让主窗口捕获自己的事件，和子控件的事件毫无关联。

2. 对事件传播机制的误解
   Qt的事件传播分两种场景：

   • 同一控件的多个事件过滤器会按安装顺序链式执行，返回False表示事件继续传递给下一个过滤器，直到控件自身的event方法。
   • 父控件不会自动接收子控件的未处理事件到自己的eventFilter，必须将父控件显式安装为子控件的事件过滤器，才能让父控件的过滤器监听子控件的事件。

将主窗口安装为子控件的事件过滤器，调整后的代码如下：

import sys
from PyQt6.QtWidgets import QApplication, QFrame, QVBoxLayout, QLabel, QPushButton
from PyQt6.QtCore import QEvent


class ChildWidget(QPushButton):
    def eventFilter(self, obj, event):
        if event.type() == QEvent.Type.MouseButtonPress:
            print("Mouse click event handled in the child widget")
            return False  # 不消耗事件，继续传递给下一个过滤器
        return super().eventFilter(obj, event)


class MainWindow(QFrame):
    def eventFilter(self, obj, event):
        if event.type() == QEvent.Type.MouseButtonPress:
            print("Mouse click event handled in the main window")
        return super().eventFilter(obj, event)


def main():
    app = QApplication(sys.argv)
    main_window = MainWindow()
    main_window.setWindowTitle("Event Propagation Example")
    main_window.setGeometry(100, 100, 300, 200)

    child_widget = ChildWidget("Click me! I'm the child widget")

    layout = QVBoxLayout()
    layout.addWidget(QLabel("Hello from the main window"))
    layout.addWidget(child_widget)

    main_window.setLayout(layout)

    # 修正：将主窗口安装为子控件的事件过滤器
    child_widget.installEventFilter(child_widget)  # 子控件自身的过滤器
    child_widget.installEventFilter(main_window)    # 主窗口监听子控件的事件

    main_window.show()
    sys.exit(app.exec())

if __name__ == "__main__":
    main()

运行后点击子控件，会依次输出：

Mouse click event handled in the child widget
Mouse click event handled in the main window

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