Undo/Redo设计(一)

本贴转自http://www.drgraph.com/viewthread.php?tid=105&extra=page%3D1

 

1.        总体目标
Undo/Redo功能是一常用编辑功能，便于用户进行更多的尝试编辑工作。
图形组态功能中，针对Undo/Redo功能尚未进行系统设计。为提高软件易用性与通用性，应加入该项功能设计。
可参照微软Word模式，实现Undo/Redo下拉式选择效果。
2.        设计与实现
首先，针对每个图形文件均可进行65535级Undo/Redo操作。因此，Undo/Redo的各种模型数据在各图形文件实例中都应有独立实例。
2.1        框架实现
先考虑调用需求
用户可单步Undo/Redo，亦可多步，因此，设计调用接口

 void __fastcall Undo(int stepCount = 1); void __fastcall Redo(int stepCount = 1); 

在实现时，先实现单步。
1)        添加编辑菜单项Undo/Redo，编辑多语言资源文件，中文为“撤销/重做”，英文为“Undo/Redo”
2)        添加工具条按钮，完成相应图标
3)        定义常量CBW_UNDO=-1, CBW_REDO=1;
4)        Undo的Tag为CBW_UNDO，Redo的Tag为CBW_REDO
5)        单击事件处理

void __fastcall TCbwGraphBaseForm::MenuItem_Edit_UndoClick(TObject *Sender) { int tag = GetPropValue(Sender, “Tag”); if(tag == CBW_UNDO) Undo(); else if(tag == CBW_REDO) Redo(); }

6)        Undo/Redo函数先不处理

void __fastcall TCbwGraphBaseForm::Undo(int stepCount) { ShowMessage(“Undo”); } void __fastcall TCbwGraphBaseForm::Redo(int stepCount) { ShowMessage(“Redo”); }

2.2        操作类设计
作为一个操作类，需记录操作的类型及其相关数据，以便进行撤销操作时有据可查。从直观需求而言，需记录以下信息
1)        操作所发起的窗口对象
2)        操作的类型
3)        被操作对象名称列表
4)        操作本身信息
而对外的接口主要是需自动记录用户的操作，响应用户的手动撤销/重做指令，即

void __fastcall Undo(); void __fastcall Redo();

自动记录用户的操作，即需创建相应的操作类实例，设计其构造函数为

__fastcall TCbwExecuteItem(TForm * aDestForm, CbwExecuteType AExecuteType);

操作的设计重点在于对于不同类型的操作，应记录哪些信息。
故此首先处理操作的类型，设计一个枚举类CbwExecuteType

enum CbwExecuteType // 操作类型 { cetLeft, // 左对齐 cetHCenter, // 水平中间对齐 cetRight, // 右对齐 cetHEqual, // 水平等距 cetHCenterWindow, // 与窗口中点水平对齐 cetTop, // 上对齐 cetVCenter, // 垂直中间对齐 cetBottom, // 下对齐 cetVEqual, // 垂直等距 cetVCenterWindow, // 与窗口中点垂直对齐 cetCreate, // 创建 cetCreateWire, // 创建导线 cetDelete, // 删除 cetDeleteWireLine, // 删除子导线 cetDrag, // 拖动 cetRotate, // 旋转 cetFlipHorz, // 水平翻转 cetFlipVert, // 垂直翻转 cetZoom, // 缩放 cetZoomPoint, // 控点缩放 cetCompose, // 组合 cetDecompose, // 分解 cetProperty, // 属性修改 cetMultiModelPoint, // 修改模型点 cetNormal // 无 };

用枚举类的好处在于扩充，以后有什么新的操作类型，可直接加入一个枚举量，然后对其进行相应处理即可。
首先来处理最先碰到的创建操作，该操作对应的枚举量为cetCreate。
第一件事，当然是自动记录创建操作，该操作的入口有以下几个：
1)        鼠标左键按下时：添加元件或放置图元
2)        鼠标左键弹起时：结束对象构造
3)        多点图元构造完毕
4)        粘贴操作
假定我们在以上入口处构造出创建操作类对象，即

TCbwExecuteItem * createItem = new TCbwExecuteItem(this, cetCreate);

还需将该对象加入到窗口的操作列表中去
这样，需在窗口类中设计一个数据成员，可设计为vector<TCbwExecuteItem *>类型，也可设计为TList类型，当然，从长远的角度考虑，可将TCbwExecuteItem类型设计为树形，这样，每一个操作均可包含多个子操作，并负责其各子操作的生命周期管理。
到目前，TCbwExecuteItem类的大致内容为

typedef vector<TCbwExecuteItem *> CbwExecuteItems; class TCbwExecuteItem : public TObject { private: TForm * FDestForm; // 操作所发起的窗口对象 CbwExecuteType FExecuteType; // 操作类别 CbwExecuteItems FItems; // 本操作项所包含的子操作项列表 public: __fastcall TCbwExecuteItem(TForm * destForm = NULL, CbwExecuteType executeType = cetNormal); __fastcall ~TCbwExecuteItem(); void __fastcall Add(TCbwExecuteItem * item); // 添加一个子操作 void __fastcall Delete(int index); // 删除指定位置的子操作 TCbwExecuteItem * __fastcall ItemAt(int index); // 取得指定位置的子操作 int __fastcall GetCount(); // 返回子操作项的数目 }; __fastcall TCbwExecuteItem::TCbwExecuteItem( TForm * destForm, CbwExecuteType executeType) : TObject() { // 构造函数 FDestForm = destForm; FExecuteType = executeType; } __fastcall TCbwExecuteItem::~TCbwExecuteItem() { // 析构函数 FlushVector(FItems, true); } void __fastcall TCbwExecuteItem::Add(TCbwExecuteItem * item) { // 添加一个子操作项 FItems.push_back(item); } TCbwExecuteItem * __fastcall TCbwExecuteItem::ItemAt(int index) { // 取得指定位置的子操作项 if(index < 0 || index >= Count) return NULL; return FItems[index]; } void __fastcall TCbwExecuteItem::Delete(int index) { // 删除指定位置的子操作项 if(index >= 0 && index < Count) { TCbwExecuteItem * item = FItems[index]; FItems.erase(FItems.begin() + index); delete item; } } int __fastcall TCbwExecuteItem::GetCount() { // 返回子操作项的数目 return FItems.size(); }

而在窗口类中，加入成员

TCbwExecuteItem * FExecuteItem; // 本窗口中操作记录对象 int FExecuteIndex; // 当前操作项在FExecuteItem中索引值

而开始记录操作时，设计一个共用函数

TCbwExecuteItem * __fastcall TCbwGraphBaseForm::BeginExecuteItem(CbwExecuteType executeType) { // 用户手动开始一项操作 ++FExecuteIndex; // 增加下标 if(FExecuteIndex >= 0) // 维护本项操作为最后一项可Undo的操作 while(FExecuteItem->Count > FExecuteIndex) FExecuteItem->Delete(FExecuteIndex); if(object == NULL) // 操作对象 object = cSelectedObjects; GlobalExecuteItem = new TCbwExecuteItem(this, executeType); FExecuteItem->Add(GlobalExecuteItem); // 添加到操作项列表中 return GlobalExecuteItem; }

同样，结束记录操作时，设计一个公用函数

void __fastcall TCbwGraphBaseForm::EndExecuteItem() { // 用户手动操作结束 if(GlobalExecuteItem) { if(!GlobalExecuteItem->IsValid) { // 在结束时，判断该操作是否已经完备，如果不完备，则该操作不能被撤销 // 不完备的情况：取消了操作，如创建多点对象过程中，按下ESC即取消 FExecuteItem->Delete(FExecuteIndex); // GlobalExecuteItem在此被删除 --FExecuteIndex; } else GlobalExecuteItem->Finish(); // 结束操作项记录，流入到XML节点中 } GlobalExecuteItem = NULL; }

在此基础上，可直接完成窗口的Undo/Redo操作函数，即将工作交由TCbwExecuteItem类完成

void __fastcall TCbwGraphBaseForm::Undo(int stepCount)
{
   if(FExecuteIndex >= 0)
   {
      TCbwExecuteItem * item = FExecuteItem->ItemAt(FExecuteIndex);
      if(item)
         item->Undo();
   }
   --FExecuteIndex;
   if(FExecuteIndex < 0)
   {
      FExecuteIndex = -1;
      FFileModifiedFlag = false;
   }
   if(--stepCount)       
          Undo(stepCount);
}

void __fastcall TCbwGraphBaseForm::Redo(int stepCount)
{
   TCbwExecuteItem * item = FExecuteItem->ItemAt(FExecuteIndex);
   if(item)
   {
      ++FExecuteIndex;
      item->Redo();
   }
   if(--stepCount)
          Redo(stepCount);
}

剩下的事就是TCbwExecuteItem的了，先还是啥也不做

void __fastcall TCbwExecuteItem::Undo(TCbwGraphBaseForm * destForm){} // 撤销本步操作 void __fastcall TCbwExecuteItem::Redo(TCbwGraphBaseForm * destForm){} // 重做本步操作

针对各操作类型的核心设计工作，现在才开始。