Options
All
  • Public
  • Public/Protected
  • All
Menu

Class Transaction

Hierarchy

  • Transaction

A Transaction holds a list of ChangedEvents collected during a transaction, as the value of the read-only changes property.

Start a transaction by calling UndoManager.startTransaction (or Model.startTransaction or Diagram.startTransaction, which call that method). Be sure to finish a transaction with a matching call to UndoManager.commitTransaction (or Model.commitTransaction or Diagram.commitTransaction), or a call to UndoManager.rollbackTransaction (or the same named methods on Model or Diagram).

If you are performing multiple or repeated changes to a model or diagram, surround all of the code with calls to start and commit the transaction -- do not perform repeated calls to start-commit-start-commit. Typically each change caused by the user, such as a button click or a change of focus or a mouse drag, should perform one transaction in which all changes are made. All of the predefined commands and tools perform transactions.

Undoing or redoing a transaction is done by calling UndoManager.undo or UndoManager.redo. Those methods call the undo or redo methods here.

The UndoManager holds a list of Transactions in its UndoManager.history.

Index

Constructors

Properties

  • This read-only property returns the list of ChangedEvents. The changes are stored in order of occurrence.

    You should not modify this list.

Methods

  • canRedo(): boolean
  • This predicate returns true if you can call redo, namely when isComplete is true.

    Returns boolean

    true if ready for redo to be called.

  • canUndo(): boolean
  • This predicate returns true if you can call undo, namely when isComplete is true.

    Returns boolean

    true if ready for undo to be called.

  • clear(): void
  • Clear all of the saved changes.

    Returns void

  • optimize(): void
  • Remove all but the first and last Property ChangedEvents for each property for each object.

    This is now called by DraggingTool.stopTransaction in order to reduce the memory saved by each dragging transaction.

    since

    2.2

    Returns void

  • redo(): void
  • Re-perform these changes after an undo. This is normally called only by the UndoManager. canRedo must be true for this method to have any effect.

    Returns void

  • undo(): void
  • Undo all of the changes, in reverse order. This is normally called only by the UndoManager. canUndo must be true for this method to have any effect.

    Returns void