PyQt5如何添加复选框实现两个QSlider滑块数值同步锁定功能

1. 界面调整（Qt Designer端） #

• 打开项目对应的ui文件，新增QCheckBox控件，设置显示文本为「锁定滑块同步」，记录该控件的objectName（示例中用checkBox_lock_sync指代）
• 确认两个待同步QSlider控件的objectName（示例中分别用horizontalSlider_1、horizontalSlider_2指代）
• 保存ui后按你项目的原有流程处理：用pyuic/pyside-uic编译为Python文件，或直接用uic动态加载均可

2. 逻辑代码实现 #

核心逻辑为通过复选框状态控制两个滑块valueChanged信号的绑定与解绑，同步时阻塞对应控件信号避免递归触发：

# 以下为PyQt5示例代码，PySide2/PySide6/PyQt6仅需调整导入语句即可
from PyQt5.QtWidgets import QMainWindow

class YourMainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        # 此处保留你原有初始化代码，如加载ui、控件初始化等
        self.sync_lock = False
        # 绑定复选框状态变更信号
        self.checkBox_lock_sync.stateChanged.connect(self.toggle_sync)

    def toggle_sync(self, state):
        # Qt.Checked对应值为2，即勾选状态
        self.sync_lock = state == 2
        if self.sync_lock:
            # 勾选时先统一两个滑块数值，默认取第一个滑块的当前值
            self.horizontalSlider_2.setValue(self.horizontalSlider_1.value())
            # 绑定滑块数值变更信号
            self.horizontalSlider_1.valueChanged.connect(self.sync_slider1)
            self.horizontalSlider_2.valueChanged.connect(self.sync_slider2)
        else:
            # 取消勾选时解绑信号，捕获异常避免未绑定时的报错
            try:
                self.horizontalSlider_1.valueChanged.disconnect(self.sync_slider1)
                self.horizontalSlider_2.valueChanged.disconnect(self.sync_slider2)
            except TypeError:
                pass

    def sync_slider1(self, val):
        if self.sync_lock:
            # 阻塞目标滑块信号，避免双向触发导致的递归问题
            self.horizontalSlider_2.blockSignals(True)
            self.horizontalSlider_2.setValue(val)
            self.horizontalSlider_2.blockSignals(False)

    def sync_slider2(self, val):
        if self.sync_lock:
            self.horizontalSlider_1.blockSignals(True)
            self.horizontalSlider_1.setValue(val)
            self.horizontalSlider_1.blockSignals(False)

3. 适配注意事项 #

• 将代码中所有控件的objectName替换为你项目中实际的控件命名，否则会出现属性不存在报错
• 两个滑块已设置0-100的取值范围，无需额外调整参数即可完全同步
• 若需要滑块数值反向同步，仅需在setValue时将val替换为100-val即可

内容的提问来源于stack exchange，提问作者Love-to-Make