lib
KoCommandHistory Class Reference
#include <KoCommandHistory.h>
Detailed Description
The command history stores a (user) configurable amount of Commands.History of user commands (for undo/redo).It keeps track of its size and deletes commands if it gets too large. The user can set a maximum undo and a maximum redo limit (e.g. max. 50 undo / 30 redo commands). The KoCommandHistory keeps track of the "borders" and deletes commands, if appropriate. It also activates/deactivates the undo/redo actions in the menu and changes the text according to the name of the command.
Definition at line 58 of file KoCommandHistory.h.
Public Slots | |
virtual void | undo () |
virtual void | redo () |
virtual void | documentSaved () |
Signals | |
void | commandExecuted () |
void | commandExecuted (KCommand *cmd) |
void | documentRestored () |
Public Member Functions | |
KoCommandHistory () | |
KoCommandHistory (KActionCollection *actionCollection, bool withMenus=true) | |
virtual | ~KoCommandHistory () |
void | clear () |
void | addCommand (KCommand *command, bool execute=true) |
int | undoLimit () const |
void | setUndoLimit (int limit) |
int | redoLimit () const |
void | setRedoLimit (int limit) |
void | updateActions () |
KCommand * | presentCommand () |
Protected Slots | |
void | slotUndoAboutToShow () |
void | slotUndoActivated (int) |
void | slotRedoAboutToShow () |
void | slotRedoActivated (int) |
void | slotUndoActivated (QListBoxItem *) |
void | slotRedoActivated (QListBoxItem *) |
void | slotChangeRedoNumberOfSelectedItem (int) |
void | slotChangeUndoNumberOfSelectedItem (int) |
Protected Member Functions | |
virtual void | virtual_hook (int id, void *data) |
Constructor & Destructor Documentation
KoCommandHistory::KoCommandHistory | ( | ) |
Creates a command history, to store commands.
This constructor doesn't create actions, so you need to call undo and redo yourself.
Definition at line 79 of file KoCommandHistory.cpp.
KoCommandHistory::KoCommandHistory | ( | KActionCollection * | actionCollection, | |
bool | withMenus = true | |||
) |
Creates a command history, to store commands.
This also creates an undo and a redo action, in the actionCollection
, using the standard names ("edit_undo" and "edit_redo").
- Parameters:
-
actionCollection the collection to put the history in. withMenus if true, the actions will display a menu when plugged into a toolbar.
Definition at line 87 of file KoCommandHistory.cpp.
KoCommandHistory::~KoCommandHistory | ( | ) | [virtual] |
Member Function Documentation
void KoCommandHistory::addCommand | ( | KCommand * | command, | |
bool | execute = true | |||
) |
Adds a command to the history.
Call this for each command
you create. Unless you set execute
to false, this will also execute the command. This means, most of the application's code will look like:
MyCommand * cmd = new MyCommand(i18n("The Name"), parameters); m_historyCommand.addCommand( cmd );
Definition at line 170 of file KoCommandHistory.cpp.
void KoCommandHistory::clear | ( | ) |
Erases all the undo/redo history.
Use this when reloading the data, for instance, since this invalidates all the commands.
Definition at line 157 of file KoCommandHistory.cpp.
void KoCommandHistory::commandExecuted | ( | KCommand * | cmd | ) | [signal] |
Emitted every time a command is executed (whether by addCommand, undo or redo).
You can use this to update the GUI, for instance.
- Parameters:
-
command was executed
void KoCommandHistory::commandExecuted | ( | ) | [signal] |
Emitted every time a command is executed (whether by addCommand, undo or redo).
You can use this to update the GUI, for instance.
void KoCommandHistory::documentRestored | ( | ) | [signal] |
Emitted every time we reach the index where you saved the document for the last time.
See documentSaved
void KoCommandHistory::documentSaved | ( | ) | [virtual, slot] |
Remembers when you saved the document.
Call this right after saving the document. As soon as the history reaches the current index again (via some undo/redo operations) it will emit documentRestored If you implemented undo/redo properly the document is the same you saved before.
Definition at line 302 of file KoCommandHistory.cpp.
KCommand * KoCommandHistory::presentCommand | ( | ) |
- Returns:
- the current top item on the history stack
Definition at line 152 of file KoCommandHistory.cpp.
void KoCommandHistory::redo | ( | ) | [virtual, slot] |
Redoes the last undone action.
Call this if you don't use the builtin KActions.
Definition at line 261 of file KoCommandHistory.cpp.
int KoCommandHistory::redoLimit | ( | ) | const [inline] |
- Returns:
- the maximum number of items in the redo history
Definition at line 112 of file KoCommandHistory.h.
void KoCommandHistory::setRedoLimit | ( | int | limit | ) |
Sets the maximum number of items in the redo history.
Definition at line 320 of file KoCommandHistory.cpp.
void KoCommandHistory::setUndoLimit | ( | int | limit | ) |
Sets the maximum number of items in the undo history.
Definition at line 312 of file KoCommandHistory.cpp.
void KoCommandHistory::undo | ( | ) | [virtual, slot] |
Undoes the last action.
Call this if you don't use the builtin KActions.
Definition at line 222 of file KoCommandHistory.cpp.
int KoCommandHistory::undoLimit | ( | ) | const [inline] |
- Returns:
- the maximum number of items in the undo history
Definition at line 104 of file KoCommandHistory.h.
void KoCommandHistory::updateActions | ( | ) |
Enable or disable the undo and redo actions.
This isn't usually necessary, but this method can be useful if you disable all actions (to go to a "readonly" state), and then want to come back to a readwrite mode.
Definition at line 434 of file KoCommandHistory.cpp.
The documentation for this class was generated from the following files: