Kivy中Carousel滑动时获取当前图片名称的实现问题

我在Kivy的EzLaunchScreen类中从指定路径加载图片到Carousel组件，代码如下：

class EzLaunchScreen(Screen):     
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        img_path = ('D:\\Steven\Desktop\\Python App\\Images\\Carousel\\')
        # Funtion get images int carousel...
        layout = FloatLayout()
        self.background_image = Image(source='Images\launchScreen.png')
        carousel_widget = Carousel(direction ='right')
        for img_file in os.listdir(img_path):
            if img_file.endswith(('.png', '.jpg', '.jpeg')):
                img = Image(source=os.path.join(img_path, img_file))
                print(f"Adding image: {img_file}")
                carousel_widget.add_widget(img)       
        layout.add_widget(self.background_image)       
        layout.add_widget(carousel_widget)
        self.add_widget(layout)

同时编写了kv语言代码定义界面，包含触发swipe_me方法的按钮及Carousel的on_slide事件：

Code = '''
<EzLaunchScreen>: 
    brand_text: Brand_label  
    val_text: ToT_label
    slide_text: slider_label
    name: 'EzLaunch' 

   
    BoxLayout:  

        Button:
            background_color: 0, 0, 0, 0
            size_hint: .25, .070  
            on_press: app.swipe_me()  
            pos_hint: {'center_x': 0.10, 'center_y': .975} 

        # This is the carousel library of brands...
        Carousel: 
            id: carousel_widget        
            direction: 'right'
            on_slide: root.swipe_me()

'''

我尝试实现swipe_me函数来获取滑动Carousel时当前显示的图片名称，但以下代码未成功：

def swipe_me(self, carousel_widget_instance, value):
        current_image = carousel_widget_instance.slides[carousel_widget_instance.index]
        image_name = current_image.image_name  # Access the stored name

        print(f"Current image name: {image_name}")

问题根源 #

1. 手动创建的Image控件没有image_name属性，直接访问会触发属性不存在的错误。
2. Python代码中创建的Carousel和kv文件中定义的是两个独立实例，导致事件关联失效；同时kv中on_slide事件的参数传递不符合方法要求。

修复步骤 #

1. 统一Carousel实例，延迟加载图片

删除Python代码中手动创建Carousel的逻辑，改用kv文件中定义的carousel_widget实例。通过Clock.schedule_once延迟加载图片，确保kv文件解析完成后能获取到正确的控件实例：

from kivy.clock import Clock

class EzLaunchScreen(Screen):     
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        img_path = 'D:\\Steven\\Desktop\\Python App\\Images\\Carousel\\'
        # 延迟执行图片加载，确保kv已完成解析
        Clock.schedule_once(lambda dt: self.load_images(img_path))

    def load_images(self, img_path):
        carousel_widget = self.ids.carousel_widget
        for img_file in os.listdir(img_path):
            if img_file.endswith(('.png', '.jpg', '.jpeg')):
                img = Image(source=os.path.join(img_path, img_file))
                # 给Image控件添加自定义属性存储文件名
                img.image_name = img_file
                print(f"Adding image: {img_file}")
                carousel_widget.add_widget(img)

2. 修正swipe_me方法的参数与逻辑

kv中on_slide事件默认传递两个参数：Carousel实例和当前显示的slide。调整方法逻辑直接从当前slide读取自定义属性：

def swipe_me(self, carousel, current_slide):
    # 检查属性存在性，避免报错
    if hasattr(current_slide, 'image_name'):
        print(f"Current image name: {current_slide.image_name}")
    else:
        print("当前slide未存储图片名称")

3. 调整kv文件的事件传递逻辑

修改kv中on_slide和按钮on_press的参数传递，确保方法能收到正确的实例：

<EzLaunchScreen>: 
    brand_text: Brand_label  
    val_text: ToT_label
    slide_text: slider_label
    name: 'EzLaunch' 

    FloatLayout:
        # 背景图直接在kv中定义，避免重复布局
        Image:
            source: 'Images\\launchScreen.png'

        BoxLayout:  
            size_hint: 1, 0.1
            pos_hint: {'center_y': .975}

            Button:
                background_color: 0, 0, 0, 0
                size_hint: .25, 1  
                on_press: root.swipe_me(root.ids.carousel_widget, root.ids.carousel_widget.current_slide)
                pos_hint: {'center_x': 0.10} 

        Carousel: 
            id: carousel_widget        
            direction: 'right'
            # 传递Carousel实例和当前slide给swipe_me
            on_slide: root.swipe_me(self, args[1])

完整可运行代码示例 #

from kivy.app import App
from kivy.uix.screenmanager import Screen
from kivy.uix.image import Image
from kivy.clock import Clock
import os

class EzLaunchScreen(Screen):     
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        img_path = 'D:\\Steven\\Desktop\\Python App\\Images\\Carousel\\'
        Clock.schedule_once(lambda dt: self.load_images(img_path))

    def load_images(self, img_path):
        carousel_widget = self.ids.carousel_widget
        for img_file in os.listdir(img_path):
            if img_file.endswith(('.png', '.jpg', '.jpeg')):
                img = Image(source=os.path.join(img_path, img_file))
                img.image_name = img_file
                print(f"Adding image: {img_file}")
                carousel_widget.add_widget(img)

    def swipe_me(self, carousel, current_slide):
        if hasattr(current_slide, 'image_name'):
            print(f"Current image name: {current_slide.image_name}")
        else:
            print("当前slide未存储图片名称")

class MyApp(App):
    def build(self):
        from kivy.lang import Builder
        Builder.load_string('''
<EzLaunchScreen>: 
    brand_text: Brand_label  
    val_text: ToT_label
    slide_text: slider_label
    name: 'EzLaunch' 

    FloatLayout:
        Image:
            source: 'Images\\launchScreen.png'

        BoxLayout:  
            size_hint: 1, 0.1
            pos_hint: {'center_y': .975}

            Button:
                background_color: 0, 0, 0, 0
                size_hint: .25, 1  
                on_press: root.swipe_me(root.ids.carousel_widget, root.ids.carousel_widget.current_slide)
                pos_hint: {'center_x': 0.10} 

        Carousel: 
            id: carousel_widget        
            direction: 'right'
            on_slide: root.swipe_me(self, args[1])
''')
        return EzLaunchScreen()

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

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