Kivy问题：控制器无法接收Popup派发的事件

我一直在Kivy中尝试接收来自Popup的简单事件，能确认事件已被派发，但控制器完全接收不到任何信息。耗费数小时排查无果后，我编写了一个简单的Kivy测试应用，问题仍未解决。

测试代码 #

from kivy.app import App
from kivy.uix.popup import Popup
from kivy.uix.button import Button
from kivy.uix.label import Label
from kivy.event import EventDispatcher
from kivy.uix.boxlayout import BoxLayout
from kivy.clock import Clock

class ManualAnalysisPopup(Popup, EventDispatcher):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.setup_ui()
        self.register_event_types()

    def register_event_types(self):
        self.register_event_type('on_apply_pattern')
        print("ManualAnalysisPopup: Registered on_apply_pattern event")
        
    def on_apply_pattern(self):
        print("ManualAnalysisPopup: on_apply_pattern event fired")

    def setup_ui(self):
        self.title = "Manual Image Analysis"
        self.size_hint = (0.9, 0.9)

        self.image_widget = Label(text="Image Placeholder")

        apply_button = Button(text="Apply Pattern")
        apply_button.bind(on_release=lambda btn: self.apply_pattern())

        button_layout = BoxLayout(orientation='vertical')
        button_layout.add_widget(self.image_widget)
        button_layout.add_widget(apply_button)

        self.content = button_layout

    def apply_pattern(self):
        print("Applying pattern")
        self.dispatch('on_apply_pattern')



class ManualAnalysisController(EventDispatcher):
    def __init__(self):
        super().__init__()
        self.popup = ManualAnalysisPopup()
        Clock.schedule_once(lambda dt: self.bing_view_events())
        self.show_popup()

    def bing_view_events(self):
        self.popup.bind(on_apply_pattern=self.handle_apply_pattern)
        print("ManualAnalysisController: Events bound successfully")

    def show_popup(self):
        self.popup.open()

    def handle_apply_pattern(self, instance, *args):
        print("Handling apply pattern event")


class MyApp(App):
    def build(self):
        controller = ManualAnalysisController()

if __name__ == "__main__":
    MyApp().run()

点击按钮后的输出 #

ManualAnalysisController: Events bound successfully
Applying pattern
ManualAnalysisPopup: on_apply_pattern event fired

问题原因及解决方法 #

问题核心在于自定义事件的处理方法签名不符合Kivy规范：
Kivy要求所有事件处理方法必须接收instance作为第一个参数，原代码中的on_apply_pattern方法缺少该参数，导致绑定的控制器回调无法被正确触发。

具体修改步骤： #

1. 修改ManualAnalysisPopup中的on_apply_pattern方法，添加instance参数：

def on_apply_pattern(self, instance):
    print("ManualAnalysisPopup: on_apply_pattern event fired")

2. 派发事件时，需要传递自身作为instance参数：

def apply_pattern(self):
    print("Applying pattern")
    self.dispatch('on_apply_pattern', self)

3. 修正控制器中的方法名拼写错误：bing_view_events改为bind_view_events（虽不影响功能，但避免混淆）。

修改后的完整代码 #

from kivy.app import App
from kivy.uix.popup import Popup
from kivy.uix.button import Button
from kivy.uix.label import Label
from kivy.event import EventDispatcher
from kivy.uix.boxlayout import BoxLayout
from kivy.clock import Clock

class ManualAnalysisPopup(Popup, EventDispatcher):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.setup_ui()
        self.register_event_types()

    def register_event_types(self):
        self.register_event_type('on_apply_pattern')
        print("ManualAnalysisPopup: Registered on_apply_pattern event")
        
    def on_apply_pattern(self, instance):
        print("ManualAnalysisPopup: on_apply_pattern event fired")

    def setup_ui(self):
        self.title = "Manual Image Analysis"
        self.size_hint = (0.9, 0.9)

        self.image_widget = Label(text="Image Placeholder")

        apply_button = Button(text="Apply Pattern")
        apply_button.bind(on_release=lambda btn: self.apply_pattern())

        button_layout = BoxLayout(orientation='vertical')
        button_layout.add_widget(self.image_widget)
        button_layout.add_widget(apply_button)

        self.content = button_layout

    def apply_pattern(self):
        print("Applying pattern")
        self.dispatch('on_apply_pattern', self)



class ManualAnalysisController(EventDispatcher):
    def __init__(self):
        super().__init__()
        self.popup = ManualAnalysisPopup()
        Clock.schedule_once(lambda dt: self.bind_view_events())
        self.show_popup()

    def bind_view_events(self):
        self.popup.bind(on_apply_pattern=self.handle_apply_pattern)
        print("ManualAnalysisController: Events bound successfully")

    def show_popup(self):
        self.popup.open()

    def handle_apply_pattern(self, instance, *args):
        print("Handling apply pattern event")


class MyApp(App):
    def build(self):
        controller = ManualAnalysisController()

if __name__ == "__main__":
    MyApp().run()

修改后点击按钮，输出会新增控制器的处理日志：

ManualAnalysisController: Events bound successfully
Applying pattern
ManualAnalysisPopup: on_apply_pattern event fired
Handling apply pattern event

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