Search code examples
pythonpyqtpyqt5signals-slotsqtablewidget

QTableWidget: signal to detect start of cell edit


I have a PyQt5 QTableWidget with two connected signals. One signal is meant to fire and print text to the screen when the user starts editing a cell in the table; the other is meant to fire and print text when the user finishes editing.

The latter works by connecting a function to the cellChanged signal; however, the cellActivated signal doesn't fire when the user starts editing a cell in the table.

To be clear: I want a catch-all signal for any time the cell editing starts (i.e. when the blinking cursor appears in a table cell indicating the user can now type in the cell). So connecting to the doubleClick signal will not do the trick. Although, I would settle for just having it fire when the user begins editing by pressing the enter key.

Here is my code:

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_())

To reiterate, I'm looking for a solution for printing the text "Start Cell Edit" whenever a cell of the table begins to be edited.


Solution

  • There are several different ways to do this. One way is to reimplement the edit method of the table-widget, and emit a custom signal:

    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
    

    However, if you're using Qt Designer, it might be preferrable to avoid sub-classing the table-widget, and use an item-delegate instead:

    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)