// Purpose: interface of wxCommandProcessor and wxCommand
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
Must be supplied for the command processor to display the command
name in the application's edit menu.
*/
- wxCommand(bool canUndo = false, const wxString& name = NULL);
+ wxCommand(bool canUndo = false, const wxString& name = wxEmptyString);
/**
Destructor.
processor that the action is not undoable and should not be
added to the command history.
*/
- bool Do();
+ virtual bool Do() = 0;
/**
Returns the command name.
How you implement this command is totally application dependent, but
typical strategies include:
-
+
- Perform an inverse operation on the last modified piece of data in
the document. When redone, a copy of data stored in command is pasted
back or some operation reapplied. This relies on the fact that you
processor that the action is not redoable and no change should
be made to the command history.
*/
- bool Undo();
+ virtual bool Undo() = 0;
};
void SetUndoAccelerator(const wxString& accel);
/**
- Submits a new command to the command processor. The command processor
- calls wxCommand::Do() to execute the command; if it succeeds, the
- command is stored in the history list, and the associated edit menu (if
- any) updated appropriately. If it fails, the command is deleted
- immediately. Once Submit() has been called, the passed command should
- not be deleted directly by the application.
+ Submits a new command to the command processor.
+
+ The command processor calls wxCommand::Do() to execute the command;
+ if it succeeds, the command is stored in the history list, and the
+ associated edit menu (if any) updated appropriately.
+ If it fails, the command is deleted immediately. Once Submit() has been
+ called, the passed command should not be deleted directly by the application.
+ @param command
+ The command to submit
@param storeIt
Indicates whether the successful command should be stored in the
history list.