QUndoCommand 是 Qt 提供的用于实现撤销(undo)和重做(redo)功能的基类,它是 Qt 的 Undo Framework 的核心组件。其表示一个可以执行、撤销和重做的单一命令或操作。通过将应用程序的操作封装为 QUndoCommand 的子类,可以轻松实现撤销/重做功能。
核心概念
-
QUndoCommand:每个命令都是
QUndoCommand类的一个实例,它代表了一个可以撤销或重做的操作。你需要继承这个类并实现undo()和redo()方法来定义具体的操作行为。 -
QUndoStack:这是一个命令的栈,用于存储和管理一系列的
QUndoCommand。你可以将命令压入栈中(通过调用push()方法),然后利用栈的特性轻松地执行撤销和重做操作。 -
QUndoGroup:如果你的应用程序有多个撤销堆栈(例如,在不同的视图或文档中有各自的撤销堆栈),你可以使用
QUndoGroup来管理和切换这些堆栈。
实现步骤
-
创建自定义命令:
- 继承
QUndoCommand并实现undo()和redo()方法。 - 在构造函数中,通常需要保存执行此命令所需的数据状态,以便于后续的撤销和重做操作。
- 继承
-
推入命令到栈:
- 使用
QUndoStack::push(QUndoCommand *command)方法将你的命令对象添加到撤销栈中。一旦命令被推入栈中,它就会立即被执行(即redo()被调用)。
- 使用
-
提供用户界面:
- 为用户提供一种方式来触发撤销和重做操作,这通常是通过菜单项或工具栏按钮实现的。可以连接
QUndoStack的undo()和redo()信号到相应的槽函数上。
- 为用户提供一种方式来触发撤销和重做操作,这通常是通过菜单项或工具栏按钮实现的。可以连接
基本用法
1. 创建自定义命令类
#include <QUndoCommand>
class AddItemCommand : public QUndoCommand
{
public:
AddItemCommand(MyModel *model, const QModelIndex &parent, const QString &text, QUndoCommand *parent = nullptr)
: QUndoCommand(parent), m_model(model), m_parent(parent), m_text(text)
{
setText("Add item"); // 设置命令的描述文本
}
void undo() override
{
m_model->removeRow(m_row, m_parent);
}
void redo() override
{
m_row = m_model->addItem(m_parent, m_text);
}
private:
MyModel *m_model;
QModelIndex m_parent;
QString m_text;
int m_row;
};

最低0.47元/天 解锁文章
590

被折叠的 条评论
为什么被折叠?



