]> git.saurik.com Git - wxWidgets.git/blame - include/wx/cmdproc.h
Added simplistic makefile/project files for wxWinCE.
[wxWidgets.git] / include / wx / cmdproc.h
CommitLineData
1e6feb95
VZ
1///////////////////////////////////////////////////////////////////////////////
2// Name: wx/cmdproc.h
3// Purpose: undo/redo capable command processing framework
4// Author: Julian Smart (extracted from docview.h by VZ)
5// Modified by:
6// Created: 05.11.00
7// RCS-ID: $Id$
8// Copyright: (c) wxWindows team
9// Licence: wxWindows licence
10///////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_CMDPROC_H_
13#define _WX_CMDPROC_H_
14
af49c4b8 15#if defined(__GNUG__) && !defined(__APPLE__)
1e6feb95
VZ
16 #pragma interface "cmdproc.h"
17#endif
18
19#include "wx/object.h"
20#include "wx/list.h"
21
22// ----------------------------------------------------------------------------
23// wxCommand: a single command capable of performing itself
24// ----------------------------------------------------------------------------
25
26class WXDLLEXPORT wxCommand : public wxObject
27{
28public:
2b5f62a0 29 wxCommand(bool canUndoIt = FALSE, const wxString& name = wxT(""));
1e6feb95
VZ
30 ~wxCommand();
31
32 // Override this to perform a command
33 virtual bool Do() = 0;
34
35 // Override this to undo a command
36 virtual bool Undo() = 0;
37
38 virtual bool CanUndo() const { return m_canUndo; }
39 virtual wxString GetName() const { return m_commandName; }
40
41protected:
42 bool m_canUndo;
43 wxString m_commandName;
44
45private:
46 DECLARE_CLASS(wxCommand)
47};
48
49// ----------------------------------------------------------------------------
50// wxCommandProcessor: wxCommand manager
51// ----------------------------------------------------------------------------
52
53class WXDLLEXPORT wxCommandProcessor : public wxObject
54{
55public:
56 // if max number of commands is -1, it is unlimited
57 wxCommandProcessor(int maxCommands = -1);
58 virtual ~wxCommandProcessor();
59
60 // Pass a command to the processor. The processor calls Do(); if
61 // successful, is appended to the command history unless storeIt is FALSE.
62 virtual bool Submit(wxCommand *command, bool storeIt = TRUE);
63
64 // just store the command without executing it
65 virtual void Store(wxCommand *command);
66
67 virtual bool Undo();
68 virtual bool Redo();
69 virtual bool CanUndo() const;
70 virtual bool CanRedo() const;
71
72 virtual void Initialize();
73 virtual void SetMenuStrings();
74
75#if wxUSE_MENUS
76 // Call this to manage an edit menu.
77 void SetEditMenu(wxMenu *menu) { m_commandEditMenu = menu; }
78 wxMenu *GetEditMenu() const { return m_commandEditMenu; }
79#endif // wxUSE_MENUS
80
81 // command list access
82 wxList& GetCommands() const { return (wxList&) m_commands; }
83 wxCommand *GetCurrentCommand() const
84 {
85 return (wxCommand *)(m_currentCommand ? m_currentCommand->Data() : NULL);
86 }
87 int GetMaxCommands() const { return m_maxNoCommands; }
88 virtual void ClearCommands();
89
6aa3ea88
JS
90 // By default, the accelerators are "\tCtrl+Z" and "\tCtrl+Y"
91 const wxString& GetUndoAccelerator() const { return m_undoAccelerator; }
92 const wxString& GetRedoAccelerator() const { return m_redoAccelerator; }
93
94 void SetUndoAccelerator(const wxString& accel) { m_undoAccelerator = accel; }
95 void SetRedoAccelerator(const wxString& accel) { m_redoAccelerator = accel; }
96
1e6feb95
VZ
97protected:
98 // for further flexibility, command processor doesn't call wxCommand::Do()
99 // and Undo() directly but uses these functions which can be overridden in
100 // the derived class
101 virtual bool DoCommand(wxCommand& cmd);
102 virtual bool UndoCommand(wxCommand& cmd);
103
104 int m_maxNoCommands;
105 wxList m_commands;
106 wxNode* m_currentCommand;
107
108#if wxUSE_MENUS
109 wxMenu* m_commandEditMenu;
110#endif // wxUSE_MENUS
111
6aa3ea88
JS
112 wxString m_undoAccelerator;
113 wxString m_redoAccelerator;
114
1e6feb95
VZ
115private:
116 DECLARE_DYNAMIC_CLASS(wxCommandProcessor)
117};
118
119#endif // _WX_CMDPROC_H_