Class orion.editor.UndoStack
The UndoStack is used to record the history of a text model associated to an view. Every change to the model is added to stack, allowing the application to undo and redo these changes.
Defined in: </shared/eclipse/e4/orion/I201404012230/bundles/org.eclipse.orion.client.editor/web/orion/editor/undoStack.js>.
Constructor Attributes | Constructor Name and Description |
---|---|
orion.editor.UndoStack(view, size)
Constructs a new UndoStack on a text view.
|
Method Attributes | Method Name and Description |
---|---|
add(change)
Adds a change to the stack.
|
|
canRedo()
Returns true if there is at least one change to redo.
|
|
canUndo()
Returns true if there is at least one change to undo.
|
|
destroy()
Destroy the undo stack.
|
|
Finishes a compound change.
|
|
Returns the redo changes.
|
|
getSize()
Returns the sizes of the stack.
|
|
Returns the undo changes.
|
|
isClean()
Returns true if current state of stack is the same
as the state when markClean() was called.
|
|
Marks the current state of the stack as clean.
|
|
redo()
Redo the last change in the stack.
|
|
reset()
Reset the stack to its original state.
|
|
setView(view)
|
|
startCompoundChange(owner)
Starts a compound change.
|
|
undo()
Undo the last change in the stack.
|
- Parameters:
- {orion.editor.TextView} view
- the text view for the undo stack.
- {Number} size Optional, Default: 100
- the size for the undo stack.
- Parameters:
- change
- the change to add.
- Returns:
- {Boolean} returns true if there is at least one change to redo.
- Returns:
- {Boolean} returns true if there is at least one change to undo.
- Returns:
- {orion.editor.TextChange[]} an array of TextChanges that are returned in the order that they occurred (most recent change last).
- Returns:
- {object} a object where object.undo is the number of changes that can be un-done, and object.redo is the number of changes that can be re-done.
- Returns:
- {orion.editor.TextChange[]} an array of TextChanges that are returned in the reverse order that they occurred (most recent change first).
For example, the application calls markClean(), then calls undo() four times and redo() four times. At this point isClean() returns true.
This function is typically called to determine if the content of the view associated with the stack has changed since the last time it was saved.
- Returns:
- {Boolean} returns if the state is the same as the state when markClean() was called.
This function is typically called when the content of view associated with the stack is saved.
- Returns:
- {Boolean} returns true if a change was re-done.
- Parameters:
- view
All changes added to stack from the time startCompoundChange() is called to the time that endCompoundChange() is called are compound on one change that can be un-done or re-done with one single call to undo() or redo().
- Parameters:
- owner
- the owner of the compound change which is called for start, end, undo and redo.
- Returns:
- the compound change
- Returns:
- {Boolean} returns true if a change was un-done.