OpenShot Library | OpenShotAudio 0.2.2
juce::UndoableAction Class Referenceabstract

Used by the UndoManager class to store an action which can be done and undone. More...

#include <juce_UndoableAction.h>

+ Inheritance diagram for juce::UndoableAction:

Public Member Functions

virtual ~UndoableAction ()=default
 Destructor.
 
virtual bool perform ()=0
 Overridden by a subclass to perform the action. More...
 
virtual bool undo ()=0
 Overridden by a subclass to undo the action. More...
 
virtual int getSizeInUnits ()
 Returns a value to indicate how much memory this object takes up. More...
 
virtual UndoableActioncreateCoalescedAction (UndoableAction *nextAction)
 Allows multiple actions to be coalesced into a single action object, to reduce storage space. More...
 

Protected Member Functions

 UndoableAction ()=default
 Creates an action.
 

Detailed Description

Used by the UndoManager class to store an action which can be done and undone.

See also
UndoManager

Definition at line 43 of file juce_UndoableAction.h.

Member Function Documentation

◆ perform()

virtual bool juce::UndoableAction::perform ( )
pure virtual

Overridden by a subclass to perform the action.

This method is called by the UndoManager, and shouldn't be used directly by applications.

Be careful not to make any calls in a perform() method that could call recursively back into the UndoManager::perform() method

Returns
true if the action could be performed.
See also
UndoManager::perform

Implemented in juce::ValueTree::SharedObject::SetPropertyAction, juce::ValueTree::SharedObject::AddOrRemoveChildAction, and juce::ValueTree::SharedObject::MoveChildAction.

◆ undo()

virtual bool juce::UndoableAction::undo ( )
pure virtual

Overridden by a subclass to undo the action.

This method is called by the UndoManager, and shouldn't be used directly by applications.

Be careful not to make any calls in an undo() method that could call recursively back into the UndoManager::perform() method

Returns
true if the action could be undone without any errors.
See also
UndoManager::perform

Implemented in juce::ValueTree::SharedObject::SetPropertyAction, juce::ValueTree::SharedObject::AddOrRemoveChildAction, and juce::ValueTree::SharedObject::MoveChildAction.

◆ getSizeInUnits()

virtual int juce::UndoableAction::getSizeInUnits ( )
inlinevirtual

Returns a value to indicate how much memory this object takes up.

Because the UndoManager keeps a list of UndoableActions, this is used to work out how much space each one will take up, so that the UndoManager can work out how many to keep.

The default value returned here is 10 - units are arbitrary and don't have to be accurate.

See also
UndoManager::getNumberOfUnitsTakenUpByStoredCommands, UndoManager::setMaxNumberOfStoredUnits

Reimplemented in juce::ValueTree::SharedObject::SetPropertyAction, juce::ValueTree::SharedObject::AddOrRemoveChildAction, and juce::ValueTree::SharedObject::MoveChildAction.

Definition at line 93 of file juce_UndoableAction.h.

◆ createCoalescedAction()

virtual UndoableAction * juce::UndoableAction::createCoalescedAction ( UndoableAction nextAction)
inlinevirtual

Allows multiple actions to be coalesced into a single action object, to reduce storage space.

If possible, this method should create and return a single action that does the same job as this one followed by the supplied action.

If it's not possible to merge the two actions, the method should return a nullptr.

Reimplemented in juce::ValueTree::SharedObject::SetPropertyAction, and juce::ValueTree::SharedObject::MoveChildAction.

Definition at line 102 of file juce_UndoableAction.h.


The documentation for this class was generated from the following file: