Rogue Wave Views Foundation Package API Reference Guide |
Rogue Wave Views Documentation Home |
A command stack allowing the implementation of the undo/redo functionality. More...
#include <ilviews/base/command.h>
Public Member Functions | |
IlvCommandHistory (IlUInt n=64) | |
Constructor. More... | |
void | add (IlvAction *c) |
Adds an action or a command to the history. More... | |
virtual IlBoolean | canRedo (IlUInt n=1) const |
Specifies whether there are at least n commands that can be redone. More... | |
virtual IlBoolean | canUndo (IlUInt n=1) const |
Specifies whether there are at least n commands that can be undone. More... | |
void | closeMacro () |
Closes the macro that is currently open, if any, and places it on top of the stack of added commands. More... | |
IlBoolean | isMacroRecording () const |
Specifies whether calls to add , undo , and redo are currently delegated to an internally opened macro, or are handled by the history itself. | |
IlvCommand * | lastUndoneCommand () |
Returns the last undone command. More... | |
void | openMacro (const IlString &name) |
Opens a macro for storing a list of commands that can be undone or redone in a single operation. More... | |
virtual void | redo (IlUInt n=1) |
Redoes the last n undone commands. More... | |
void | setMacroName (const IlString &name) |
Sets the user name of the internal macro that is currently open, if there is one. More... | |
virtual void | undo (IlUInt n=1) |
Undoes the last n commands added to the history. More... | |
Public Member Functions inherited from IlvActionHistory | |
IlvActionHistory (IlUInt max=8) | |
Constructor. More... | |
virtual | ~IlvActionHistory () |
Destructor. | |
void | addProperty (const IlSymbol *key, IlAny value) |
Adds a property. More... | |
virtual IlvAction * | canRepeat () |
Specifies whether the last executed action can be repeated. More... | |
IlvAction * | getAction (IlUInt i) const |
Returns the i th action stored in the history. More... | |
IlvValueInterface *const * | getCurrentSelection (IlUInt &c) |
Simplifies access to the current selection in the attached document. More... | |
IlvAction * | getLast () const |
Shortcut method for getAction(0) . More... | |
IlUInt | getLength () const |
Returns the number of actions stored in the history. More... | |
IlUInt | getMaxLength () const |
Returns the maximum number of commands that can be stored in the history. More... | |
IlAny | getProperty (const IlSymbol *key) const |
Gets a property value. More... | |
IlvActionSelectionHandler * | getSelectionHandler () const |
Returns the selection handler attached to this history. More... | |
IlBoolean | hasProperty (const IlSymbol *key) const |
Checks if a property exists. More... | |
virtual void | purge (IlUInt n=(IlUInt)-1) |
Purges the history of recorded actions or commands. More... | |
IlBoolean | recordValueChanges () const |
Indicates whether changes to objects should be recorded as commands. More... | |
IlBoolean | removeProperty (const IlSymbol *key) |
Removes a property. More... | |
virtual void | repeatLast () |
Repeats the last action stored in the history. More... | |
IlBoolean | replaceProperty (const IlSymbol *key, IlAny value) |
Replaces a property. More... | |
virtual void | setMaxLength (IlUInt maxLength) |
Sets the maximum number of commands that can be stored in the history. More... | |
void | setRecordValueChanges (IlBoolean b) |
Enables or disables command recording when objects are modified. More... | |
void | setSelectionHandler (IlvActionSelectionHandler *handler) |
Attaches a selection handler to a history. More... | |
Public Member Functions inherited from IlvObservable | |
IlvObservable () | |
Empty constructor. More... | |
virtual void | notify (IlAny arg=0) |
Notification method, to be called in methods that modify the state of the object whenever required. More... | |
Public Member Functions inherited from IlvSmartData | |
IlvSmartData () | |
Constructor. More... | |
IlvSmartData (const IlvSmartData &data) | |
Copy constructor. More... | |
virtual | ~IlvSmartData () |
Destructor. | |
void | decrRef () |
Decrements the reference counter of the object and deletes this object when the counter reaches 0. More... | |
void | incrRef () |
Increments the reference counter. | |
int | refCount () |
Returns the number of references to this object. More... | |
A command stack allowing the implementation of the undo/redo functionality.
Library: views
The class IlvCommandHistory
handles a stack of commands that are applied to objects held by a manager or any object holder, such as a document class, and lets you undo and redo these commands.
A request for undo
pops a command out of the stack, and applies its inverse command. The redo
operation redoes the last undone command and puts it back on top of the stack. The repeat
operation takes the last command or action executed, duplicates it, and puts it on top of the stack.
IlvCommandHistory::IlvCommandHistory | ( | IlUInt | n = 64 | ) |
Constructor.
For the command history to be fully functional, you should attach it to an IlvActionSelectionHandler
object by calling setSelectionHandler
after it has been created.
n | The maximum number of commands that can be stored in the history list. |
|
virtual |
Adds an action or a command to the history.
If the action is a command, it is executed, if necessary, and added to the list. If it is not command, the action is executed and deleted if it has not been reparented (that is, it has not been added to another IlvActionHistory
by an external observer).
If a macro is currently open, the command is added to this macro. Otherwise it is simply added to the list. If there are undone commands left in the stack, these commands are destroyed.
c | The action or command to be added to the history. |
Reimplemented from IlvActionHistory.
Specifies whether there are at least n commands that can be redone.
This includes any commands added to the internally opened macro command, if there is one.
n | The number of commands. |
Specifies whether there are at least n commands that can be undone.
n | The number of commands that are checked. |
IlTrue
if the last n commands can be undone, or IlFalse
if at least one of the last n command cannot be undone. void IlvCommandHistory::closeMacro | ( | ) |
Closes the macro that is currently open, if any, and places it on top of the stack of added commands.
If a macro is currently open, the method simply decrements an internal counter. If this counter equals 0, the macro is closed and put back on top of the stack.
IlvCommand* IlvCommandHistory::lastUndoneCommand | ( | ) |
Returns the last undone command.
0
if there is none. void IlvCommandHistory::openMacro | ( | const IlString & | name | ) |
Opens a macro for storing a list of commands that can be undone or redone in a single operation.
If a macro is currently open, the method simply increments an internal counter and returns. Otherwise, it creates an IlvMacroCommand
object, to which all subsequent calls to add
, undo
, and redo
) will be delegated, until a call to closeMacro
closes the internal macro command and put it on the stack of executed commands.
name | The user name to be used in commands. This name is searched for in the message database associated with the display. |
|
virtual |
Redoes the last n undone commands.
This method takes the last undone command added to the undo stack, calls its redo
method, notifies all the observers of the command history that it has been redone, and pushes the command back on top of the stack of added commands, thus allowing it to be undone again. If a macro is currently open, the redo operation is delegated to the internally opened IlvMacroCommand
. The operation is repeated n times.
n | The number of commands to be redone. |
void IlvCommandHistory::setMacroName | ( | const IlString & | name | ) |
Sets the user name of the internal macro that is currently open, if there is one.
name | The string that identifies, for the end user, the name of the currently opened macro. |
|
virtual |
Undoes the last n commands added to the history.
This method takes the last added command, calls its undo
method, and notifies all the observers of the command history that it has been undone. Then, it adds the undone command on top of the stack of undone commands. This operation is repeated for the last n added commands. If a macro is currently open, the undo operation is delegated to the internally opened IlvMacroCommand
.
n | The number of commands to be undone. |
© Copyright 2016, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.