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
|
/***************************************************************************
MenuRoot.h - root node of a menu structure
-------------------
begin : Mon Jan 10 2000
copyright : (C) 2000 by Thomas Eschenbacher
email : Thomas.Eschenbacher@gmx.de
***************************************************************************/
/***************************************************************************
* *
* 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 MENU_ROOT_H
#define MENU_ROOT_H
#include "config.h"
#include <QList>
#include "libgui/MenuNode.h"
class QMenuBar;
namespace Kwave
{
class MenuSub;
/**
* This is the class for the root of a Menu (e.g. a MenuBar) that contains
* all toplevel menus of a menu hierarchy.
* @author Thomas Eschenbacher
*/
class MenuRoot: public Kwave::MenuNode
{
Q_OBJECT
public:
/**
* Constructor.
* @param bar reference to a QMenuBar
*/
explicit MenuRoot(QMenuBar &bar);
/** Destructor */
~MenuRoot() override;
/**
* overloaded version from MenuNode, which does a cleanup of
* the "garbage collector" afterwards.
*
* @see MenuNode::insertNode()
*
* @param name non-localized name of the first node (might be 0)
* @param position path consiting of several node names separated
* by a '/'. All strings are non-localized.
* @param command the command to be sent when the node is
* selected (might be 0)
* @param shortcut keyboard shortcut, 0 if unused
* @param uid unique id string (might be 0)
*/
virtual void insertNode(const QString &name,
const QString &position,
const QString &command,
const QKeySequence &shortcut,
const QString &uid) override;
/**
* Inserts a new branch node into the menu structure.
*
* @param name non-localized name of the node
* @param command the command template used for creating commands of
* submenus (leafes) that don't have an own command
* but contain data for their parent's command.
* Should contain a %s that will be replaced by some
* data from a child entry. (this is used for
* menus with data selection lists like "recent files)
* If not used, pass 0.
* @param shortcut keyboard shortcut, 0 if unused
* @param uid unique id string (might be 0)
* @return pointer to the new branch node
*/
virtual Kwave::MenuSub *insertBranch(const QString &name,
const QString &command,
const QKeySequence &shortcut,
const QString &uid)
override;
/**
* Inserts a new leaf node into the menu structure. The new node
* normally is (derived from) MenuItem.
* @param name non-localized name of the node
* @param command the command to be sent when the node is
* selected (might be 0)
* @param shortcut keyboard shortcut, 0 if unused
* @param uid unique id string (might be 0)
* @return pointer to the new leaf node
*/
virtual Kwave::MenuNode *insertLeaf(const QString &name,
const QString &command,
const QKeySequence &shortcut,
const QString &uid)
override;
/**
* Removes a child node of the current node. If the child
* was not found or is already removed this does nothing.
* @param child pointer to the child node
*/
void removeChild(Kwave::MenuNode *child) override;
/**
* Handles/interprets special menu commands.
* @param command name of a menu node or command
* @return true if the name was recognized as a command and handled
*/
bool specialCommand(const QString &command) override;
/**
* Returns a pointer to the list of groups
*/
QHash<QString, Kwave::MenuGroup *> &groupList() override;
/**
* replacement for QObject::deleteLater(...), which does not work
* in this context
*/
static void deleteLater(Kwave::MenuNode *node);
protected:
friend class MenuSub;
/**
* Makes a child node visible, by adding it to the menu bar
* @param child pointer to the child node (normally a MenuSub)
*/
void showChild(Kwave::MenuSub *child);
/**
* Makes a child node invisible, by removing it from the menu bar
* @param child pointer to the child node (normally a MenuSub)
*/
void hideChild(Kwave::MenuSub *child);
private:
/** reference to a QMenuBar */
QMenuBar &m_menu_bar;
/** list of menu groups */
QHash<QString, Kwave::MenuGroup *> m_group_list;
/** list of nodes to delete, as deleteLater() does not work :-( */
static QList <Kwave::MenuNode *> m_garbage;
};
}
#endif // _MENU_ROOT_H_
//***************************************************************************
//***************************************************************************
|
