如何在KivyMD中手动切换MDSegmentedControl的选中项？

问题描述 #

需要在无需手动点击的场景下（如从数据库加载数据后）切换MDSegmentedControl的选中分段，尝试直接设置current_active_segment属性为目标MDSegmentedControlItem，但界面无任何变化。目前仅能通过模拟鼠标点击实现切换，但该方案不可靠。

示例代码：

from kivymd.app import MDApp
from kivy.lang import Builder
from kivy.core.window import Window
from kivy.metrics import dp
from kivy.input.providers.mouse import MouseMotionEvent
from kivy.clock import Clock

kvFloatLayout = """
MDScreen:
    id: mdscr
    
    MDBoxLayout:
        orientation: "vertical"
        adaptive_height: True
        pos_hint: {"top": 1}
        spacing: "12dp"
        
        MDTopAppBar:
            id: top_app_bar
            pos_hint: {"top": 1}
            title: "Test App"
            elevation: 4
                        
        MDBoxLayout:
            orientation: "vertical"
            adaptive_height: True
            pos_hint: {"top": 1}
            padding: "12dp", "0dp", "12dp", "12dp"
            spacing: "12dp"
            
            MDRaisedButton:
                id: btn_resize
                text: "Resize"
                on_release: app.seg_resize()
               
            MDRaisedButton:
                id: btn_change
                text: "Change selection"
                on_release: app.seg_change_selection()
                
            MDSegmentedControl:
                id: seg_options
                MDSegmentedControlItem:
                    id: sci_option1
                    text: "Option left"
                MDSegmentedControlItem:
                    id: sci_option2
                    text: "Option right"
                    
"""

class TestApp(MDApp):
    
    def build(self):
        return Builder.load_string(kvFloatLayout)

    def seg_resize(self):
        self.root.ids.seg_options.ids.segment_panel.width = (Window.width - dp(24))
        
    def seg_change_selection(self):
        sc = self.root.ids.seg_options
        print("---sc:")
        print(sc)
        sci = self.root.ids.sci_option2
        print("---sci:")
        print(sci)
        print("---sc.current_active_segment before:")
        print(sc.current_active_segment)
        sc.current_active_segment = sci
        print("---sc.current_active_segment after:")
        print(sc.current_active_segment.text)
        # 不可靠的模拟点击方案
        #Clock.schedule_once(self.simulate_mouse_click, 1)
     
    def simulate_mouse_click(self, *args):
        x = 0.75*Window.width
        y = Window.height - \
            self.root.ids.top_app_bar.height - \
            self.root.ids.btn_resize.height - \
            self.root.ids.btn_change.height - \
            dp(12) * 3 - 40
        touch = MouseMotionEvent(None, 0, (x,y))
        touch.button = 'left'
        touch.pos = (x,y)
        touch.x = touch.px = touch.ox = x
        touch.y = touch.py = touch.oy = y
        print("---touch")
        print(str(touch))
        Window.dispatch('on_touch_down', touch)
        
TestApp().run()

解决思路与方案 #

直接赋值current_active_segment后界面无变化，是因为该属性的赋值未触发MDSegmentedControl内部的状态更新逻辑。以下两种方法可实现可靠切换：

方法1：调用内部切换方法switch_active_segment #

MDSegmentedControl内置了switch_active_segment方法，该方法会同步更新选中状态和界面显示。修改seg_change_selection方法如下：

def seg_change_selection(self):
    sc = self.root.ids.seg_options
    target_segment = self.root.ids.sci_option2
    # 调用内置切换方法
    sc.switch_active_segment(target_segment)
    print("当前选中分段:", sc.current_active_segment.text)

方法2：赋值后手动触发界面更新 #

若需保留直接赋值current_active_segment的方式，可在赋值后调用update_segment_panel方法强制刷新界面：

def seg_change_selection(self):
    sc = self.root.ids.seg_options
    target_segment = self.root.ids.sci_option2
    sc.current_active_segment = target_segment
    # 强制更新面板显示状态
    sc.update_segment_panel()
    print("当前选中分段:", sc.current_active_segment.text)

原理说明 #

current_active_segment属性仅用于存储当前选中项，赋值操作不会自动触发视觉状态更新；switch_active_segment方法则会同时处理属性更新和界面切换逻辑（如滑块移动、按钮样式变化）；update_segment_panel方法专门负责同步面板的显示状态，确保界面与数据一致。

内容的提问来源于stack exchange，提问作者Paweł Pilch