QTableWidget：检测单元格编辑开始的信号

Posted 2023-03-25

【中文标题】QTableWidget：检测单元格编辑开始的信号

【英文标题】：QTableWidget: signal to detect start of cell edit

【发布时间】：2018-06-02 00:35:41

【问题描述】：

我有一个带有两个连接信号的 PyQt5 QTableWidget。一个信号用于在用户开始编辑表格中的单元格时触发并将文本打印到屏幕上；另一个用于在用户完成编辑时触发并打印文本。

后者通过将函数连接到cellChanged 信号来工作；但是，当用户开始编辑表格中的单元格时，cellActivated 信号不会触发。

明确一点：我希望在单元格编辑开始时（即当闪烁的光标出现在表格单元格中，表示用户现在可以在单元格中输入时）有一个包罗万象的信号。所以连接到doubleClick 信号不会成功。虽然，当用户按回车键开始编辑时，我会满足于让它触发。

这是我的代码：

from PyQt5 import QtCore, QtWidgets

class Ui_MainWindow(object):
    def setupUi(self, MainWindow):
        MainWindow.setObjectName("MainWindow")
        MainWindow.resize(790, 472)
        self.centralwidget = QtWidgets.QWidget(MainWindow)
        self.centralwidget.setObjectName("centralwidget")
        self.tbwMain = QtWidgets.QTabWidget(self.centralwidget)
        self.tbwMain.setGeometry(QtCore.QRect(0, 0, 801, 451))
        self.tbwMain.setObjectName("tbwMain")
        self.tabBoxes = QtWidgets.QWidget()
        self.tabBoxes.setObjectName("tabBoxes")
        self.horizontalLayoutWidget = QtWidgets.QWidget(self.tabBoxes)
        self.horizontalLayoutWidget.setGeometry(QtCore.QRect(0, 0, 791, 421))
        self.horizontalLayoutWidget.setObjectName("horizontalLayoutWidget")
        self.horizontalLayout = QtWidgets.QHBoxLayout(self.horizontalLayoutWidget)
        self.horizontalLayout.setContentsMargins(0, 0, 0, 0)
        self.horizontalLayout.setObjectName("horizontalLayout")
        spacerItem = QtWidgets.QSpacerItem(220, 40, QtWidgets.QSizePolicy.Minimum, QtWidgets.QSizePolicy.Expanding)
        self.horizontalLayout.addItem(spacerItem)
        self.tblBoxes = QtWidgets.QTableWidget(self.horizontalLayoutWidget)
        self.tblBoxes.setVerticalScrollBarPolicy(QtCore.Qt.ScrollBarAlwaysOn)
        self.tblBoxes.setVerticalScrollMode(QtWidgets.QAbstractItemView.ScrollPerPixel)
        self.tblBoxes.setRowCount(1)
        self.tblBoxes.setObjectName("tblBoxes")
        self.tblBoxes.setColumnCount(3)
        item = QtWidgets.QTableWidgetItem()
        self.tblBoxes.setHorizontalHeaderItem(0, item)
        item = QtWidgets.QTableWidgetItem()
        self.tblBoxes.setHorizontalHeaderItem(1, item)
        item = QtWidgets.QTableWidgetItem()
        self.tblBoxes.setHorizontalHeaderItem(2, item)
        item = QtWidgets.QTableWidgetItem()
        item.setTextAlignment(QtCore.Qt.AlignCenter)
        self.tblBoxes.setItem(0, 0, item)
        item = QtWidgets.QTableWidgetItem()
        item.setTextAlignment(QtCore.Qt.AlignCenter)
        self.tblBoxes.setItem(0, 1, item)
        item = QtWidgets.QTableWidgetItem()
        item.setTextAlignment(QtCore.Qt.AlignCenter)
        self.tblBoxes.setItem(0, 2, item)
        self.tblBoxes.horizontalHeader().setStretchLastSection(True)
        self.tblBoxes.verticalHeader().setVisible(False)
        self.horizontalLayout.addWidget(self.tblBoxes)
        spacerItem1 = QtWidgets.QSpacerItem(220, 40, QtWidgets.QSizePolicy.Minimum, QtWidgets.QSizePolicy.Expanding)
        self.horizontalLayout.addItem(spacerItem1)
        self.tbwMain.addTab(self.tabBoxes, "")
        MainWindow.setCentralWidget(self.centralwidget)
        self.statusbar = QtWidgets.QStatusBar(MainWindow)
        self.statusbar.setObjectName("statusbar")
        MainWindow.setStatusBar(self.statusbar)
        self.retranslateUi(MainWindow)
        self.tbwMain.setCurrentIndex(0)
        QtCore.QMetaObject.connectSlotsByName(MainWindow)

    def retranslateUi(self, MainWindow):

        # - - - - -
        self.tblBoxes.cellActivated.connect(self.test1)
        self.tblBoxes.cellChanged.connect(self.test2)

    def test1(self):
        print('Start cell edit!')
    def test2(self):
        print('End cell edit!')

if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    MainWindow = QtWidgets.QMainWindow()
    ui = Ui_MainWindow()
    ui.setupUi(MainWindow)
    MainWindow.show()
    sys.exit(app.exec_())

重申一下，我正在寻找一种解决方案，用于在开始编辑表格的单元格时打印文本“开始单元格编辑”。

【参考方案1】：

有几种不同的方法可以做到这一点。一种方法是重新实现表格小部件的edit method，并发出自定义信号：

class TableWidget(QtWidgets.QTableWidget):
    cellEditingStarted = QtCore.pyqtSignal(int, int)

    def edit(self, index, trigger, event):
        result = super(TableWidget, self).edit(index, trigger, event)
        if result:
            self.cellEditingStarted.emit(index.row(), index.column())
        return result

但是，如果您使用的是 Qt Designer，最好避免对表格小部件进行子类化，而是使用 item-delegate：

class ItemDelegate(QtWidgets.QStyledItemDelegate):
    cellEditingStarted = QtCore.pyqtSignal(int, int)

    def createEditor(self, parent, option, index):
        result = super(ItemDelegate, self).createEditor(parent, option, index)
        if result:
            self.cellEditingStarted.emit(index.row(), index.column())
        return result

class Ui_MainWindow(object):
    ...
    def retranslateUi(self, MainWindow):
        self.delegate = ItemDelegate(MainWindow)
        self.delegate.cellEditingStarted.connect(self.test1)
        self.tblBoxes.setItemDelegate(self.delegate)
        self.tblBoxes.cellActivated.connect(self.test2)

【讨论】：

我使用的是后者，因为我使用的是 QtDesigner。很好用，谢谢！

如果您还想捕捉退出编辑模式的事件，无论单元格内容是否更改，例如用于阻止 GUI 更新和重绘： self.delegate.cellEditingStarted.connect(lambda : self.blockSignals(True)) self.delegate.closeEditor.connect(lambda : self.blockSignals(False))