使用setEnabled()无法禁用QPushButton的问题排查

我在类的__init__函数中定义了QPushButton：

self.datashowbtn = QPushButton("View")
self.datashowbtn.clicked.connect(self.DrawQualCurve)

为避免用户在数据处理期间触发按钮，我在处理函数里禁用按钮：

def DrawQualCurve(self):    
    print("DrawCurve")
    self.datashowbtn.setEnabled(False)
    #此处处理数据并绘制曲线

但运行时用户仍能在DrawQualCurve执行期间点击按钮，不确定是否需要设置其他状态或参数？

调试Demo代码 #

import sys
from PySide6.QtWidgets import QApplication, QMainWindow, QPushButton
from PySide6.QtCore import QThread,Signal

class Mythread(QThread):
    finishParse = Signal(bool)
    def __init__(self):
        super(Mythread, self).__init__()
    def run(self):
        #data routine
        self.finishParse.emit(False)
        for index in range(20):
            print("do something here!")
            self.msleep(300)
        self.finishParse.emit(True)    
        self.exit()

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        
        self.setWindowTitle("My App")
        self.datashowbtn = QPushButton("View")
        self.demothread = Mythread()
        self.datashowbtn.clicked.connect(self.DrawQualCurve)
        self.datashowbtn.setCheckable(True)
        self.setCentralWidget(self.datashowbtn)
        

    def DrawQualCurve(self):
        print("DrawCurve")
        self.datashowbtn.setEnabled(False)
        self.demothread.finishParse.connect(self.ParseDone)
        self.demothread.start()
    def ParseDone(self):
        print("ParseDone")
        self.datashowbtn.setEnabled(True)
        
app = QApplication(sys.argv)
window = MainWindow()
window.show()
app.exec_()

测试发现 #

• 在DrawQualCurve中启动线程前，setEnabled(False)能正常工作；
• 线程任务越繁重，问题越容易复现，例如把self.msleep(300)改成self.msleep(10)时，问题几乎不会出现。

核心原因 #

Qt的UI操作依赖**主线程（GUI线程）**的事件循环，调用setEnabled(False)后，按钮状态的更新需要等待事件循环处理请求。如果此时主线程资源被占用（或事件循环被阻塞），禁用状态还未生效时，用户的点击事件就已经被处理。另外，Demo中self.demothread是单例线程，QThread对象只能启动一次，二次点击时启动失败也会导致按钮禁用逻辑失效。

修复代码 #

import sys
from PySide6.QtWidgets import QApplication, QMainWindow, QPushButton
from PySide6.QtCore import QThread, Signal, Qt

class Mythread(QThread):
    finishParse = Signal(bool)
    def __init__(self):
        super(Mythread, self).__init__()
        self._is_running = True

    def run(self):
        for index in range(20):
            if not self._is_running:
                break
            print("do something here!")
            self.msleep(300)
        self.finishParse.emit(True)

    def stop(self):
        self._is_running = False

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        
        self.setWindowTitle("My App")
        self.datashowbtn = QPushButton("View")
        self.datashowbtn.clicked.connect(self.DrawQualCurve)
        self.setCentralWidget(self.datashowbtn)
        self.current_thread = None

    def DrawQualCurve(self):
        print("DrawCurve")
        # 禁用按钮并强制刷新UI，确保状态立即生效
        self.datashowbtn.setEnabled(False)
        self.datashowbtn.repaint()
        
        # 停止正在运行的旧线程
        if self.current_thread and self.current_thread.isRunning():
            self.current_thread.stop()
            self.current_thread.wait()
        
        # 创建新线程并连接信号（避免重复连接）
        self.current_thread = Mythread()
        self.current_thread.finishParse.connect(self.ParseDone, Qt.UniqueConnection)
        self.current_thread.start()

    def ParseDone(self, success):
        print("ParseDone")
        self.datashowbtn.setEnabled(True)
        # 清理线程资源
        self.current_thread.finishParse.disconnect(self.ParseDone)
        self.current_thread = None
        
app = QApplication(sys.argv)
window = MainWindow()
window.show()
app.exec_()

关键优化点 #

1. 每次点击创建新线程实例，避免重复启动同一线程的问题；
2. 调用repaint()强制刷新按钮UI，确保禁用状态立即生效；
3. 给线程添加停止标志_is_running，替代强制终止的terminate()，避免资源泄漏；
4. 使用Qt.UniqueConnection防止多次点击后信号累积触发重复回调。

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