Size: 2170
Comment:
|
Size: 3238
Comment:
|
Deletions are marked like this. | Additions are marked like this. |
Line 30: | Line 30: |
A ''local'' edit is one that is done in the context of a single network view, such as adding a new Cy''''''Node to a Cy''''''Network by dragging a shape from the palette in the Cytoscape''''''Editor. A ''global'' edit is and edit that has ramifications across multiple networks and network views, such as editing the value of a node attribute in the Attribute''''''Browser. | |
Line 35: | Line 34: |
A ''local'' edit is one that is done in the context of a single network view, such as adding a new Cy''''''Node to a Cy''''''Network by dragging a shape from the palette in the Cytoscape''''''Editor. A ''global'' edit is and edit that has ramifications across multiple networks and network views, such as editing the value of a node attribute in the Attribute''''''Browser. To support undo and redo, a component must remember each edit that occurs, the order of edits, and what it takes to undo and redo each edit. A component uses an instance of the Undo''''''Manager class to manage its list of undoable edits. The Undo''''''Manager manages the list by keeping a stack of undoable edits and a pointer to the {{{indexOfNextAdd}}}. This is described in more detail in Sun's Java tutorial at http://java.sun.com/docs/books/tutorial/uiswing/components/generaltext.html#undoableedits. The way things are currently is that Cytoscape has an Undo''''''Manager that keeps one stack of undoable edits. Thus, if a user switches network views while going through a series of undo operations, then undo operations may be performed on networks other than the one that is currently visible. This is counter-intuitive. The undo operations should be managed on a per network view basis. This is done in tools such as Microsoft Word and Power''''''Point, where undo/redo operations are managed on a per network basis. |
|
Line 41: | Line 47: |
{{{ to be written }}} |
RFC Name : UndoManager RFC |
Editor(s): Allan Kuchinsky |
About this document
This is an official Request for Comment (RFC) for UndoManager
For details on RFCs in general, check out the [http://www.answers.com/main/ntquery?method=4&dsid=2222&dekey=Request+for+Comments&gwp=8&curtab=2222_1&linktext=Request%20for%20Comments Wikipedia Entry: Request for Comments (RFCs)]
Status
January 24, 2005: "Not yet completely written"
How to Comment
To view/add comments, click on any of 'Comment' links below. By adding your ideas to the Wiki directly, we can more easily organize everyone's ideas, and keep clear records. Be sure to include today's date and your name for each comment. Here is an example to get things started: ["/Comment"].
Try to keep your comments as concrete and constructive as possible. For example, if you find a part of the RFC makes no sense, please say so, but don't stop there. Take the extra step and propose alternatives.
Proposal
Define and build an undo manager that handles both global edits and edits that are local to a specific network. Build a visual undo manager that shows operations so that users can select actions to undo.
Biological Questions / Use Cases
General Notes
A local edit is one that is done in the context of a single network view, such as adding a new CyNode to a CyNetwork by dragging a shape from the palette in the CytoscapeEditor. A global edit is and edit that has ramifications across multiple networks and network views, such as editing the value of a node attribute in the AttributeBrowser.
To support undo and redo, a component must remember each edit that occurs, the order of edits, and what it takes to undo and redo each edit. A component uses an instance of the UndoManager class to manage its list of undoable edits. The UndoManager manages the list by keeping a stack of undoable edits and a pointer to the indexOfNextAdd. This is described in more detail in Sun's Java tutorial at http://java.sun.com/docs/books/tutorial/uiswing/components/generaltext.html#undoableedits.
The way things are currently is that Cytoscape has an UndoManager that keeps one stack of undoable edits. Thus, if a user switches network views while going through a series of undo operations, then undo operations may be performed on networks other than the one that is currently visible. This is counter-intuitive. The undo operations should be managed on a per network view basis. This is done in tools such as Microsoft Word and PowerPoint, where undo/redo operations are managed on a per network basis.
Requirements
Deferred Items
Open Issues
to be written
Backward Compatibility
Expected growth and plan for growth
References
Implementation Plan
- ["/Implementation Plan"]