PyQt5中如何在QTableWidget的handleItemChanged中获取旧值

直接通过itemChanged信号无法获取修改前的旧值——这个信号是在单元格内容完成更新后才触发的，参数里的QTableWidgetItem已经是修改后的状态。不过可以通过以下几种方案实现需求：

方案一：维护全局字典存储历史值 #

初始化时把所有单元格的值存入字典，每次触发itemChanged时从字典读取旧值，对比后再更新字典内容。这种方法适合小型表格，实现简单直观。

import sys
from PyQt5.QtWidgets import *

class MyWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.table_widget = QTableWidget(self)
        self.setCentralWidget(self.table_widget)

        # 初始化表格结构与内容
        self.table_widget.setColumnCount(3)
        self.table_widget.setHorizontalHeaderLabels(['Name', 'Age', 'Gender'])
        self.table_widget.setRowCount(3)
        self.table_widget.setItem(0, 0, QTableWidgetItem('John'))
        self.table_widget.setItem(0, 1, QTableWidgetItem('30'))
        self.table_widget.setItem(0, 2, QTableWidgetItem('Male'))
        self.table_widget.setItem(1, 0, QTableWidgetItem('Mary'))
        self.table_widget.setItem(1, 1, QTableWidgetItem('25'))
        self.table_widget.setItem(1, 2, QTableWidgetItem('Female'))
        self.table_widget.setItem(2, 0, QTableWidgetItem('Bob'))
        self.table_widget.setItem(2, 1, QTableWidgetItem('40'))
        self.table_widget.setItem(2, 2, QTableWidgetItem('Male'))

        # 初始化历史值字典，键为(row, column)元组
        self.cell_history = {}
        for row in range(self.table_widget.rowCount()):
            for col in range(self.table_widget.columnCount()):
                item = self.table_widget.item(row, col)
                if item:
                    self.cell_history[(row, col)] = item.text()

        self.table_widget.itemChanged.connect(self.handleItemChanged)

    def handleItemChanged(self, item):
        row = item.row()
        column = item.column()
        current_value = item.text()
        previous_value = self.cell_history.get((row, column), None)

        print(f'Edited row: {row}, column: {column}')
        print(f'Previous value: {previous_value}')
        print(f'Current value: {current_value}')
        
        if current_value != previous_value:
            print("Do something important here!")
            # 更新字典中的历史值
            self.cell_history[(row, column)] = current_value


def main():
    app = QApplication(sys.argv)
    table = MyWindow()
    table.show()
    app.exec_()

main()

方案二：给单元格添加自定义属性存储旧值 #

利用QTableWidgetItem的setData和data方法，使用自定义角色（比如Qt.UserRole + 1）存储单元格的上一次值，每次修改后更新这个属性。这种方法不需要额外维护全局字典，数据和单元格绑定更紧密。

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import *

class MyWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.table_widget = QTableWidget(self)
        self.setCentralWidget(self.table_widget)

        # 初始化表格结构
        self.table_widget.setColumnCount(3)
        self.table_widget.setHorizontalHeaderLabels(['Name', 'Age', 'Gender'])
        self.table_widget.setRowCount(3)
        
        # 初始化单元格并存储初始值到自定义角色
        items = [
            ('John', '30', 'Male'),
            ('Mary', '25', 'Female'),
            ('Bob', '40', 'Male')
        ]
        for row, (name, age, gender) in enumerate(items):
            name_item = QTableWidgetItem(name)
            name_item.setData(Qt.UserRole + 1, name)
            self.table_widget.setItem(row, 0, name_item)
            
            age_item = QTableWidgetItem(age)
            age_item.setData(Qt.UserRole + 1, age)
            self.table_widget.setItem(row, 1, age_item)
            
            gender_item = QTableWidgetItem(gender)
            gender_item.setData(Qt.UserRole + 1, gender)
            self.table_widget.setItem(row, 2, gender_item)

        self.table_widget.itemChanged.connect(self.handleItemChanged)

    def handleItemChanged(self, item):
        row = item.row()
        column = item.column()
        current_value = item.text()
        previous_value = item.data(Qt.UserRole + 1)

        print(f'Edited row: {row}, column: {column}')
        print(f'Previous value: {previous_value}')
        print(f'Current value: {current_value}')
        
        if current_value != previous_value:
            print("Do something important here!")
            # 更新自定义角色存储的旧值
            item.setData(Qt.UserRole + 1, current_value)


def main():
    app = QApplication(sys.argv)
    table = MyWindow()
    table.show()
    app.exec_()

main()

方案三：拦截编辑开始事件记录旧值 #

通过重写QItemDelegate的createEditor方法，在用户开始编辑单元格时记录旧值。这种方法适合需要精确捕获编辑起始时机的场景，但仅支持单单元格编辑的情况（多单元格同时编辑会导致旧值被覆盖）。

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import *

class CustomDelegate(QItemDelegate):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.previous_value = None

    def createEditor(self, parent, option, index):
        # 记录编辑前的原始值
        self.previous_value = index.data(Qt.DisplayRole)
        return super().createEditor(parent, option, index)

class MyWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.table_widget = QTableWidget(self)
        self.setCentralWidget(self.table_widget)

        # 设置自定义代理
        self.delegate = CustomDelegate(self)
        self.table_widget.setItemDelegate(self.delegate)

        # 初始化表格内容
        self.table_widget.setColumnCount(3)
        self.table_widget.setHorizontalHeaderLabels(['Name', 'Age', 'Gender'])
        self.table_widget.setRowCount(3)
        self.table_widget.setItem(0, 0, QTableWidgetItem('John'))
        self.table_widget.setItem(0, 1, QTableWidgetItem('30'))
        self.table_widget.setItem(0, 2, QTableWidgetItem('Male'))
        self.table_widget.setItem(1, 0, QTableWidgetItem('Mary'))
        self.table_widget.setItem(1, 1, QTableWidgetItem('25'))
        self.table_widget.setItem(1, 2, QTableWidgetItem('Female'))
        self.table_widget.setItem(2, 0, QTableWidgetItem('Bob'))
        self.table_widget.setItem(2, 1, QTableWidgetItem('40'))
        self.table_widget.setItem(2, 2, QTableWidgetItem('Male'))

        self.table_widget.itemChanged.connect(self.handleItemChanged)

    def handleItemChanged(self, item):
        row = item.row()
        column = item.column()
        current_value = item.text()
        previous_value = self.delegate.previous_value

        print(f'Edited row: {row}, column: {column}')
        print(f'Previous value: {previous_value}')
        print(f'Current value: {current_value}')
        
        if current_value != previous_value:
            print("Do something important here!")


def main():
    app = QApplication(sys.argv)
    table = MyWindow()
    table.show()
    app.exec_()

main()

内容的提问来源于stack exchange，提问作者sławomir sowa