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
|
/***************************************************************************
* Copyright (C) 2008-2010 by Ilya Kotov *
* forkotov02@hotmail.ru *
* *
* 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. *
* *
* This program is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
* GNU General Public License for more details. *
* *
* You should have received a copy of the GNU General Public License *
* along with this program; if not, write to the *
* Free Software Foundation, Inc., *
* 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
***************************************************************************/
#ifndef GENERALHANDLER_H
#define GENERALHANDLER_H
#include <QObject>
#include <QMap>
#include <QList>
#include <QPointer>
#include <QStringList>
class QAction;
class QMenu;
class QWidget;
class General;
class Control;
class GeneralFactory;
/*! @brief The GeneralHandler class provides simple api to access general and command line plugins.
* @author Ilya Kotov <forkotov02@hotmail.ru>
*/
class GeneralHandler : public QObject
{
Q_OBJECT
public:
/*!
* Object constructor,
* @param parent Parent object
*/
GeneralHandler(QObject *parent = 0);
/*!
* Destructor
*/
~GeneralHandler();
/*!
* Enum of menu type
*/
enum MenuType
{
TOOLS_MENU = 0, /*!< tools menu */
PLAYLIST_MENU /*!< playlist context menu */
};
/*!
* Sets whether the general plugin is enabled.
* @param factory General plugin factory.
* @param enable Plugin enable state (\b true - enable, \b false - disable)
*/
void setEnabled(GeneralFactory* factory, bool enable);
/*!
* Shows configuration dialog and updates settings automatically.
* @param factory General plugin factory.
* @param parentWidget Parent widget.
*/
void showSettings(GeneralFactory* factory, QWidget* parentWidget);
/*!
* Returns \b true if one of the general plugin can change visibility, otherwise returns \b false
*/
bool visibilityControl();
/*!
* Adds the newly created action to the menu with type \b type.
* Menu with type \b type should be created first.
* @param action Pointer of action.
* @param type Menu type.
*/
void addAction(QAction *action, MenuType type = TOOLS_MENU);
/*!
* Removes action \b action from created menus.
*/
void removeAction(QAction *action);
/*!
* Returns a list of actions of the menu type \b type
*/
QList<QAction *> actions(MenuType type = TOOLS_MENU);
/*!
* Creates menu with type \b type
* @param type Menu type.
* @param title Menu title.
* @param parent Parent widget
*/
QMenu *createMenu(MenuType type, const QString &title = QString(), QWidget *parent = 0);
/*!
* Toggles player window visibility.
*/
void toggleVisibility();
/*!
* Returns a pointer to the object's instance.
*/
static GeneralHandler* instance();
signals:
/*!
* Emitted when some general plugin requires to exit.
* Use it to quit application.
*/
void exitCalled();
/*!
* Emitted when some general plugin requires to toggle visibility.
* Use it to show/hide player's window.
*/
void toggleVisibilityCalled();
private slots:
void removeAction(QObject *action);
private:
QMap <GeneralFactory*, General*> m_generals;
QList <QAction*> m_toolsActions;
QList <QAction*> m_playlistActions;
QPointer<QMenu> m_toolsMenu;
QPointer<QMenu> m_playlistMenu;
static GeneralHandler* m_instance;
};
#endif
|
