如何撤消 PySide/PyQt 中 QListWidgetItem 的编辑？

Question

短版

如何在 PySide/PyQt 中为 QListWidgetItems 上的编辑实现撤消功能？

Qt 教程中的提示？

下面为 Qt 用户 (c++) 编写的教程可能有答案，但我不是 c++ 人，所以有点迷茫：Using Undo/Redo with Item Views

加长版

我正在使用 QListWidget 来了解 PyQt 的 Undo Framework（在 an article 的帮助下）。当我自己执行一个命令（比如从列表中删除一个项目）时，我对撤消/重做很好。

我还想让小部件中的QListWidgetItems 可编辑。这很简单：只需将ItemIsEditable 标志添加到每个项目。问题是，我怎样才能将这些编辑推送到撤消堆栈中，这样我才能撤消/重做它们？

下面是一个简单的工作示例，它显示了一个列表，可让您删除项目以及撤消/重做此类删除。应用程序同时显示列表和撤消堆栈。需要做什么才能对该堆栈进行编辑？

简单的工作示例

from PySide import QtGui, QtCore

class TodoList(QtGui.QWidget):
    def __init__(self):
        QtGui.QWidget.__init__(self)
        self.setAttribute(QtCore.Qt.WA_DeleteOnClose)
        self.initUI()
        self.show()

    def initUI(self):
        self.todoList = self.makeTodoList()
        self.undoStack = QtGui.QUndoStack(self)
        undoView = QtGui.QUndoView(self.undoStack)
        buttonLayout = self.buttonSetup()
        mainLayout = QtGui.QHBoxLayout(self)
        mainLayout.addWidget(undoView)
        mainLayout.addWidget(self.todoList)
        mainLayout.addLayout(buttonLayout)
        self.setLayout(mainLayout)
        self.makeConnections()

    def buttonSetup(self):
        #Make buttons 
        self.deleteButton = QtGui.QPushButton("Delete")
        self.undoButton = QtGui.QPushButton("Undo")
        self.redoButton = QtGui.QPushButton("Redo")
        self.quitButton = QtGui.QPushButton("Quit")
        #Lay them out
        buttonLayout = QtGui.QVBoxLayout()
        buttonLayout.addWidget(self.deleteButton)
        buttonLayout.addStretch()
        buttonLayout.addWidget(self.undoButton)
        buttonLayout.addWidget(self.redoButton)
        buttonLayout.addStretch()
        buttonLayout.addWidget(self.quitButton)
        return buttonLayout

    def makeConnections(self):
        self.deleteButton.clicked.connect(self.deleteItem)
        self.quitButton.clicked.connect(self.close)
        self.undoButton.clicked.connect(self.undoStack.undo)
        self.redoButton.clicked.connect(self.undoStack.redo)

    def deleteItem(self):
        rowSelected=self.todoList.currentRow()
        rowItem = self.todoList.item(rowSelected)
        if rowItem is None:
            return
        command = CommandDelete(self.todoList, rowItem, rowSelected,
                                "Delete item '{0}'".format(rowItem.text()))
        self.undoStack.push(command)

    def makeTodoList(self):
        todoList = QtGui.QListWidget()
        allTasks = ('Fix door', 'Make dinner', 'Read', 
                    'Program in PySide', 'Be nice to everyone')
        for task in allTasks:
            todoItem=QtGui.QListWidgetItem(task)
            todoList.addItem(todoItem)
            todoItem.setFlags(QtCore.Qt.ItemIsSelectable | QtCore.Qt.ItemIsEnabled)
        return todoList


class CommandDelete(QtGui.QUndoCommand):
    def __init__(self, listWidget, item, row, description):
        super(CommandDelete, self).__init__(description)
        self.listWidget = listWidget
        self.string = item.text()
        self.row = row

    def redo(self):
        self.listWidget.takeItem(self.row)

    def undo(self):
        addItem = QtGui.QListWidgetItem(self.string)
        addItem.setFlags(QtCore.Qt.ItemIsSelectable | QtCore.Qt.ItemIsEnabled)
        self.listWidget.insertItem(self.row, addItem)

if __name__ == "__main__":
    import sys
    app = QtGui.QApplication(sys.argv)
    myList=TodoList()
    sys.exit(app.exec_())

请注意，我在 QtCentre 发布了一个 earlier version of this question。

Answer 1

我会这样做：

创建一个自定义QItemDelegate 并使用这两个信号：

• editorEvent
• closeEditor

开启editorEvent：保存当前状态

开启closeEditor：获取新状态并创建一个QUndoCommand，为Redo 设置新状态，为Undo 设置旧状态。

Answer 2

你提到的那个教程真的不是很有帮助。视图的undo-redo实现确实有很多方法，我们只需要选择最简单的一种。如果您处理小列表，最简单的方法是保存每次更改的所有数据，并在每次撤消或重做操作时从头开始恢复完整列表。

如果您仍然想要原子更改列表，您可以使用QListWidget::itemChanged 信号跟踪用户所做的编辑。这样做有两个问题：

• 列表中的任何其他项目更改也会触发此信号，因此您需要将任何更改项目的代码包装到 QObject::blockSignals 调用中以阻止不需要的信号。
• 无法获取以前的文本，只能获取新文本。解决方案是将所有列表数据保存到变量，在更改时使用和更新它，或者在编辑之前保存已编辑项目的文本。 QListWidget 对其内部编辑器状态非常谨慎，因此我决定使用QListWidget::currentItemChanged，假设用户在不先创建当前状态的情况下找不到编辑项目的方法。

所以这是使它工作的更改（除了在两个地方添加 ItemIsEditable 标志）：

def __init__(self):
    #...
    self.todoList.itemChanged.connect(self.itemChanged)
    self.todoList.currentItemChanged.connect(self.currentItemChanged)
    self.textBeforeEdit = ""

def itemChanged(self, item):
    command = CommandEdit(self.todoList, item, self.todoList.row(item),
        self.textBeforeEdit, 
        "Rename item '{0}' to '{1}'".format(self.textBeforeEdit, item.text()))
    self.undoStack.push(command)

def currentItemChanged(self, item):
    self.textBeforeEdit = item.text()

还有新的变更类：

class CommandEdit(QtGui.QUndoCommand):
    def __init__(self, listWidget, item, row, textBeforeEdit, description):
        super(CommandEdit, self).__init__(description)
        self.listWidget = listWidget
        self.textBeforeEdit = textBeforeEdit
        self.textAfterEdit = item.text()
        self.row = row

    def redo(self):
        self.listWidget.blockSignals(True)
        self.listWidget.item(self.row).setText(self.textAfterEdit)
        self.listWidget.blockSignals(False)

    def undo(self):
        self.listWidget.blockSignals(True)
        self.listWidget.item(self.row).setText(self.textBeforeEdit)
        self.listWidget.blockSignals(False)

Answer 3

每次验证并接受项目的新文本时，将其保存为列表项目数据。准半伪代码：

OnItemEdited(Item* item)
{
    int dataRole{ 32 }; //or greater (see ItemDataRole documentation)

    if (Validate(item->text()) {

        item->setData(dataRole, item->text());

    } else { //Restore previous value

        item->setText(item->data(dataRole).toString());
    }
}

如果它看起来太像 C++，我很抱歉。