SuperMap iObjects.NET编辑撤销操作详解

作者：小诗

      在处理数据的过程中，总免不了需要编辑对象，编辑的过程中有时候会遇到需要撤回操作，返回到之前的数据状态，在SuperMap iObjects.NET中是如何实现的呢，小编在此就这功能的实现做一分享。

      在SuperMap iObjects.NET中，EditHistory表示编辑历史，该类包含有关编辑操作的历史信息。该类所记录的编辑操作历史主要是对记录集进行编辑操作的历史，包括新增操作、修改操作和删除操作。在该类中通过Add方法将对记录集的编辑操作记录添加到编辑历史中。调用此方法，可以将对记录集的操作行为记录下来，用于恢复等操作。如:

1、往地图中添加对象：

 void mapControl_GeometryAdded(object sender, GeometryEventArgs e)
 {
    DatasetVector dataset = e.Layer.Dataset as DatasetVector;
    Recordset re = dataset.Query("smid = " + e.ID, CursorType.Dynamic);
    editHistory.Add(EditType.AddNew, re, true);
    re.Dispose();
}

2、在地图中删除对象：

void mapControl_GeometryDeleting(object sender, GeometryEventArgs e)
{
   DatasetVector dataset = e.Layer.Dataset as DatasetVector;
   Recordset re = dataset.Query("smid = " + e.ID, CursorType.Dynamic);
   editHistory.Add(EditType.Delete, re, true);
   re.Dispose();
 }

3、修改对象：
当对记录集进行SetString、SetValues、SetGeometry等修改操作时就需要添加修改模式的编辑操作；

editHistory.Add(EditType.Modify, re, true);
 

注意：
      (1) Add方法中有三个参数；第一个参数为编辑操作的类型，是一个枚举型参数，包含（增加、修改、删除），表示对对象的操作类型；第二个参数为记录集，记录集需要准确定位到正在操作的那条记录。

      (2)编辑操作是以数组的形式存在在编辑历史中，你可以通过Remove(int index)（删除指定索引对应的编辑历史）或者RemoveRange(int index,int count)(删除从指定索引开始的指定数量的编辑历史)删除其中的编辑操作，也可以通过Clear（清空编辑历史）。删除后该步骤操作就不能再用于编辑撤回操作。

      在往编辑历史中添加操作步骤除了像上面所说的一个操作一条记录这样添加外，还存在着一种特殊的添加，那就是编辑造作的批量添加。也许有人会问，批量添加和单步骤的添加两者有何不同？

      在这里我给举一个应用案例大家就明白了，在SuperMap iDesktop中对象编辑中有一个打断线的功能，该功能使用SuperMap iObjects.NET组件来实现的时候，其实就是一个多步骤的操作：
      （1）分布获取点对象和线对象，使用Geometrist中的SplitLine方法执行点打短线操作，返回的结果为打断后的线对象数据；

      （2）接下来就要对结果进行处理了，首先要把原始的线对象删除，然后将返回的线对象数组中的线对象分别添加到记录集中，那么整个过程就分为了一个删除操作，两个添加操作；

      如果还是按照上面的单步骤添加，那这个操作就需要回退三步才能撤回到操作之前的状态。这个时候就需要采用批量添加，将三个步骤以一条记录存于编辑历史中，撤回和前进都存为一步操作，具体实现代码如下：

GeoLine[] result = Geometrist.SplitLine(geoline, point,0.0000001);
if (result != null)
{
    editHistory.BatchBegin();
    editHistory.Add(EditType.Delete, selection_recordset, true);
    selection_recordset.Delete(); 
    selection_recordset.MoveLast();
    for (int i = 0; i < result.Length; i++)
    {
       bool aa =  selection_recordset.AddNew(result[i]);
       selection_recordset.MoveLast();
       editHistory.Add(EditType.AddNew, selection_recordset, true);             
    }
    selection_recordset.Update();
    editHistory.BatchEnd();
    mapControl.Map.Refresh();

备注：
(1) editHistory.BatchBegin()就表示批量模式开始了，表示开始批量记录对记录集的操作行为。
(2) editHistory.BatchEnd();批量模式结束，表示结束对记录集操作行为的批量记录。到此从 BatchBegin开始到 BatchEnd之间多有的操作都会以一条记录存在于编辑历史中；
(3) 如果批量操作开始后需要取消批量操作模式的话可以用editHistory.BatchCancel方法来终止批量操作模式，也就是说BatchCancel和BatchEnd分别都是和BatchBegin配套使用的。

      将编辑操作记录添加到编辑历史中后，就可以通过CanRedo和CanUndo属性获取当前编辑历史是否可以撤回或者前进。然后通过Undo或者Redo方法来执行撤回或者前进操作了如：

 if (editHistory.CanUndo)
{
     editHistory.Undo();
}
mapControl.Map.Refresh();

 if (editHistory.CanRedo)
{
     editHistory.Redo();
}
 mapControl.Map.Refresh();

备注：
      可以直接通过CanUndo或者CanRedo判断是否可以用于撤回或者前进操作，也可以通过Count 属性获取编辑历史项的数量和CurrentIndex属性查看当前编辑历史项的索引确定是否还可以撤回或者前进。

注意：
      editHistory的Capacity属性需要在editHistory初始化后进行设置，表示编辑历史的容量，即最多能够容纳的历史项的数量。如果Add方法添加的编辑超过了设置的容量数量，前面的编辑操作会自动移除。不能用于撤回操作。所以设置这个容量的时候要根据自己的需求来酌情指定。

源码见资源中心范例：http://support.supermap.com.cn/ 在范例中搜索：编辑撤销操作