topic UndoManager's Operations in ArcGIS JavaScript Maps SDK Questions

UndoManager's Operations

MarkHoover — Thu, 30 Jun 2011 20:47:17 GMT

As per the API:

add(operation)
Adds an undo operation to the stack and clears the redo stack.
Return value: none
Input Parameters:
<Operation> operation Required An operation to add to the stack.

Code snippets:

var operation = new esri.dijit.editing.Delete({
featureLayer: layer,
deletedGraphics: [feature]
});

undoManager.add(operation);

I am curious how an Operation is defined. It is not a part of the API, and considering the wide variety of actions I would like to include, I have generally no idea how to go about defining an Operation to add to my stack, other than the ones included in the API for UndoManager and in the one Sample that uses it.

Has anyone implemented this? Any insight you could provide would be great. Our highest priority for this involves drawing graphics on the map, changing the color/scale/rotation/etc. of those graphics, deleting said graphics, etc...

Re: UndoManager's Operations

JianHuang — Fri, 01 Jul 2011 00:28:48 GMT

Mark,

You can certainly implement your own operations by extending the base class "esri.OperationBase", which requires to implement two methods�?"performUndo" and "performRedo".
Please take a look at the doc:
http://help.arcgis.com/en/webapi/javascript/arcgis/help/jsapi_start.htm#jsapi/operationbase.htm
There is a sample included.
Hope this helps.

Re: UndoManager's Operations

MarkHoover — Fri, 01 Jul 2011 12:01:10 GMT

Excellent, Jian, thanks. Perhaps UndoManager's add/remove methods should mention this?

Also, the sample provided does not include an example of inheriting from the OperationBase class. Rather, it uses the provided operations from the Editing realm (Add, Cut, Update, Union, Delete). Any chance of getting a sample showing an Operation built by inheriting from OperationBase?

Re: UndoManager's Operations

JianHuang — Fri, 01 Jul 2011 21:44:33 GMT

Mark,

There is a code snippet illustrating how to inherit the base class in the section of "Constructor Detail".

Re: UndoManager's Operations

KellyHutchins — Mon, 04 Jul 2011 05:29:57 GMT

Mark,

This sample uses a custom operation:
http://help.arcgis.com/en/webapi/javascript/arcgis/demos/graphics/graphics_undoredo.html

You can view the custom operation code here:
http://help.arcgis.com/en/webapi/javascript/arcgis/demos/graphics/myModules/customOperation.js

Re: UndoManager's Operations

MarkHoover — Tue, 05 Jul 2011 12:05:43 GMT

Jian and Kelly, thanks for the help. Those were exactly the resources I needed.