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

Posted 2021-04-21

我有一个带有两个连接信号的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_())

重申一下，无论何时开始编辑表格的单元格，我都在寻找打印文本“Start Cell Edit”的解决方案。

答案

有几种不同的方法可以做到这一点。一种方法是重新实现表格小部件的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)