File: clKeyboardManager.h

package info (click to toggle)
codelite 17.0.0%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 136,204 kB
  • sloc: cpp: 491,547; ansic: 280,393; php: 10,259; sh: 8,930; lisp: 7,664; vhdl: 6,518; python: 6,020; lex: 4,920; yacc: 3,123; perl: 2,385; javascript: 1,715; cs: 1,193; xml: 1,110; makefile: 804; cobol: 741; sql: 709; ruby: 620; f90: 566; ada: 534; asm: 464; fortran: 350; objc: 289; tcl: 258; java: 157; erlang: 61; pascal: 51; ml: 49; awk: 44; haskell: 36
file content (258 lines) | stat: -rw-r--r-- 8,186 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
//////////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////////////////////////////
//
// Copyright            : (C) 2015 Eran Ifrah
// File name            : clKeyboardManager.h
//
// -------------------------------------------------------------------------
// A
//              _____           _      _     _ _
//             /  __ \         | |    | |   (_) |
//             | /  \/ ___   __| | ___| |    _| |_ ___
//             | |    / _ \ / _  |/ _ \ |   | | __/ _ )
//             | \__/\ (_) | (_| |  __/ |___| | ||  __/
//              \____/\___/ \__,_|\___\_____/_|\__\___|
//
//                                                  F i l e
//
//    This program is free software; you can redistribute it and/or modify
//    it under the terms of the GNU General Public License as published by
//    the Free Software Foundation; either version 2 of the License, or
//    (at your option) any later version.
//
//////////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////////////////////////////

#ifndef KEYBOARDMANAGER_H
#define KEYBOARDMANAGER_H

#include "cl_command_event.h"
#include "codelite_exports.h"
#include "macros.h"
#include "wxStringHash.h"

#include <list>
#include <map>
#include <set>
#include <vector>
#include <wx/accel.h>
#include <wx/event.h>
#include <wx/frame.h>
#include <wx/menu.h>

class WXDLLIMPEXP_SDK clKeyboardShortcut
{
    wxKeyCode m_control_type = WXK_NONE;
    bool m_alt = false;
    bool m_shift = false;
    wxString m_keyCode;

    /**
     * @brief tokenize the accelerator string
     */
    wxArrayString Tokenize(const wxString& accelString) const;

protected:
    wxString to_string(bool for_ui) const;

public:
    clKeyboardShortcut() {}
    explicit clKeyboardShortcut(wxKeyCode ctrl, bool alt, bool shift, const wxString& keyCode)
        : m_control_type(ctrl)
        , m_alt(alt)
        , m_shift(shift)
        , m_keyCode(keyCode)
    {
    }
    clKeyboardShortcut(const char* accelString) { FromString(wxString(accelString)); }
    clKeyboardShortcut(const wxString& accelString) { FromString(accelString); }

    /**
     * @brief please use the FromString() instead
     */
    clKeyboardShortcut& operator=(const char* accelString) = delete;
    clKeyboardShortcut& operator=(const wxString& accelString) = delete;

    /// The control key code (can be WXK_CONTROL, WXK_RAW_CONTROL or WXK_NONE)
    wxKeyCode GetControl() const { return m_control_type; }

    /// Is the Alt key part of the accelerator?
    bool GetAlt() const { return IsOk() && m_alt; }

    /// Is the Shift key part of the accelerator?
    bool GetShift() const { return IsOk() && m_shift; }

    /// The accelerator key code (e.g. 'C')
    const wxString& GetKeyCode() const { return m_keyCode; }

    /**
     * @brief equality operators
     */
    bool operator==(const clKeyboardShortcut& rhs) const;
    bool operator!=(const clKeyboardShortcut& rhs) const { return !(*this == rhs); }

    /**
     * @brief 'less than' operator (may be used in STL containers)
     */
    bool operator<(const clKeyboardShortcut& rhs) const;

    /**
     * @brief returns true if this shortcut is valid, false otherwise
     */
    bool IsOk() const;

    /**
     * @brief clear this accelerator
     */
    void Clear();

    /**
     * @brief construct this object from string representation
     * e.g.: Ctrl-Alt-1
     */
    void FromString(const wxString& accelString);
    /**
     * @brief return a string representation of this accelerator
     */
    wxString ToString() const;

    /// Similar to `ToString` but convert `rawctrl` & `ctrl` into `Ctrl` & `Cmd` accordingly
    wxString DisplayString() const;

    using Vec_t = std::vector<clKeyboardShortcut>;
    using Set_t = std::set<clKeyboardShortcut>;
};

struct WXDLLIMPEXP_SDK MenuItemData {
    wxString resourceID;
    wxString parentMenu; // For display purposes
    wxString action;
    clKeyboardShortcut accel;

    struct ClearParentMenu {
        void operator()(std::pair<const int, MenuItemData>& iter) { iter.second.parentMenu.Clear(); }
    };

    struct PrependPrefix {
        wxString m_prefix;
        PrependPrefix(const wxString& prefix)
            : m_prefix(prefix)
        {
        }
        void operator()(std::pair<const int, MenuItemData>& iter) { iter.second.action.Prepend(m_prefix); }
    };
};

typedef std::unordered_map<wxString, MenuItemData> MenuItemDataMap_t;
typedef std::unordered_map<int, MenuItemData> MenuItemDataIntMap_t;

wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_SDK, wxEVT_KEYBOARD_ACCEL_INIT_DONE, clCommandEvent);
class WXDLLIMPEXP_SDK clKeyboardManager : public wxEvtHandler
{
private:
    typedef std::list<wxFrame*> FrameList_t;
    bool m_initialized = false;
    MenuItemDataMap_t m_accelTable;        // a set of accelerators configured by user
    MenuItemDataMap_t m_defaultAccelTable; // a set of default accelerators
    wxStringSet_t m_keyCodes;
    clKeyboardShortcut::Set_t m_allShortcuts;

    /**
     * @brief an internal struct used by the 2nd AddAccelerator() overload
     */
    struct AddAccelData {
        AddAccelData(const wxString& resourceID, const wxString& action, const clKeyboardShortcut& accel = {})
            : m_resourceID(resourceID)
            , m_action(action)
            , m_accel(accel)
        {
        }
        wxString m_resourceID;
        wxString m_action;
        clKeyboardShortcut m_accel;
    };

protected:
    /**
     * @brief return list of frames
     */
    void DoGetFrames(wxFrame* parent, clKeyboardManager::FrameList_t& frames);
    void DoUpdateMenu(wxMenu* menu, MenuItemDataIntMap_t& accels, std::vector<wxAcceleratorEntry>& table);
    void DoUpdateFrame(wxFrame* frame, MenuItemDataIntMap_t& accels);
    void DoConvertToIntMap(const MenuItemDataMap_t& strMap, MenuItemDataIntMap_t& intMap);
    MenuItemDataMap_t DoLoadAccelerators(const wxFileName& filename) const;

    clKeyboardManager();
    virtual ~clKeyboardManager();

protected:
    void OnStartupCompleted(wxCommandEvent& event);

public:
    static void Release();
    static clKeyboardManager* Get();

    /**
     * @brief return an array of all unassigned keyboard shortcuts
     */
    clKeyboardShortcut::Vec_t GetAllUnassignedKeyboardShortcuts() const;

    /**
     * @brief show a 'Add keyboard shortcut' dialog
     */
    int PopupNewKeyboardShortcutDlg(wxWindow* parent, MenuItemData& menuItemData);

    /**
     * @brief return true if the accelerator is already assigned
     */
    bool Exists(const clKeyboardShortcut& accel) const;

    /**
     * @brief save the bindings to disk
     */
    void Save();

    /**
     * @brief load bindings from the file system
     */
    void Initialize();

    /**
     * @brief add keyboard shortcut by specifying the action ID + the shortcut combination
     * For example: AddAccelerator("wxID_COPY", _("Edit"), _("Copy the current selection"), "Ctrl-Shift-C");
     */
    void AddAccelerator(const wxString& resourceID, const wxString& parentMenu, const wxString& action,
                        const clKeyboardShortcut& accel = {});

    /**
     * @brief a convenience overload for AddAccelerator() method
     * For example:
     *    AddAccelerator(_("File"), { { "wxID_OPEN", _("Open"), "Ctrl-O" }, { "wxID_CLOSE", _("Close"), "Ctrl-W" } });
     * is equivalent to:
     *    AddAccelerator("wxID_OPEN", _("File"), _("Open"), "Ctrl-O");
     *    AddAccelerator("wxID_CLOSE", _("File"), _("Close"), "Ctrl-W");
     */
    void AddAccelerator(const wxString& parentMenu, const std::vector<AddAccelData>& table);

    /**
     * @brief replace all acceleratos with 'accels'
     */
    void SetAccelerators(const MenuItemDataMap_t& accels);

    /**
     * @brief return all accelerators known to CodeLite
     */
    void GetAllAccelerators(MenuItemDataMap_t& accels) const;

    /**
     * @brief update accelerators
     */
    void Update(wxFrame* frame = NULL);

    /**
     * @brief restore keyboard shortcuts to defaults
     */
    void RestoreDefaults();
};

#endif // KEYBOARDMANAGER_H