SystemUI

An operation is an action, or group of actions, that can be undone or redone. You can implement IOperation to make an object that performs some actions that are capable of undo and redo. You are only likely to call members of IOperation if you are implementing undo and redo for a standalone application.

An application can implement an operation stack to provide undo and redo facilities. As you perform operations, they are added to the stack; then you can use undo and redo in the application to manipulate the stack to undo or redo the operations.

ArcMap has an operation stack that can be obtained with the IMxDocument.OperationStack property. ArcMap’s buttons and tools wrap their actions in an operation and add the operations to the stack.

The code below uses the operation stack to undo a previous operation. It assumes that you already have m_application variable as a reference to the Application object in your .NET custom component.

//ESRI.ArcGIS.Framework.IApplication m_application

private void Undo()
{
    ESRI.ArcGIS.ArcMapUI.IMxDocument mxDocument = (ESRI.ArcGIS.ArcMapUI.IMxDocument)
        m_application.Document;
    ESRI.ArcGIS.SystemUI.IOperationStack operationStack = mxDocument.OperationStack;
    operationStack.Undo();
}

Public Sub Undo()
    Dim pMxDoc As IMxDocument
    Set pMxDoc = ThisDocument
    pMxDoc.OperationStack.Undo
End Sub

/ / Delete?

Depending on your scenario, there are different methodologies for creating an operation and adding it to the operation stack. If your tool edits features and rows, you can use IEditor.StartOperation and IEditor.StopOperation and the actions in between will be automatically added to the operation stack as a single operation. Stopping an edit session clears the operation stack. If you are outside an edit session and updating a geodatabase directly, calls to IWorkspaceEdit.StartEditOperation and StopEditOperation will not automatically add anything to ArcMap’s operation stack since these interfaces are independent of ArcMap. For other actions, on graphic elements for example, you need to create a custom operation object that implements IOperation. The operation is executed and loaded onto the stack with a call to IOperationStack.Do.

Outside the context of ArcGIS applications such as ArcMap, you can add undo and redo capability by using the ControlsOperationStack class. Usually, you cocreate this class in conjunction with ToolbarControl and add undo and redo buttons that manipulate the operation stack via IOperationStack.

The CommandHost and ToolHost objects are used when developing with the ArcGIS C++ application programming interface (API). This enables commands and tools to be developed for UNIX platforms. A tool host holds C++ tool implementations in a toolbar. A command host holds C++ command implementations in a toolbar.