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
|
/*
For general Scribus (>=1.3.2) copyright and licensing information please refer
to the COPYING file provided with the program. Following this notice may exist
a copyright and/or license notice that predates the release of Scribus 1.3.2
for which a new license (GPL+exception) is in place.
*/
/***************************************************************************
begin : Jan 2005
copyright : (C) 2005 by Craig Bradney
email : cbradney@zip.com.au
***************************************************************************/
/***************************************************************************
* *
* 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 SCRACTION_H
#define SCRACTION_H
#include <QAction>
#include <QPixmap>
#include <QMenu>
#include "scribusapi.h"
class ScribusDoc;
/**
@author Craig Bradney
*/
class SCRIBUS_API ScrAction : public QAction
{
Q_OBJECT
public:
typedef enum {Normal, DataInt, DataDouble, DataQString, RecentFile, DLL, Window, RecentScript, UnicodeChar, Layer, ActionDLL, RecentPaste, ActionDLLSE } ActionType;
/*!
\author Craig Bradney
\date Jan 2005
\brief Constructor from QAction, sets menuType to Normal
\param parent Parent object of this action
*/
ScrAction ( QObject *parent ) ;
/*!
\author Craig Bradney
\date Jan 2005
\brief Constructor from QAction, sets menuType to normal
\param menuText Text to be in the menus for this action
\param accel Accelerator QKeySequence
\param parent Parent object of this action
*/
ScrAction( const QString &menuText, QKeySequence accel, QObject *parent );
/*!
\author Craig Bradney
\date Jan 2005
\brief Constructor for an action that may require a specific menu type, such as a DLL menu
\param mType menuType, of Normal, RecentFile or DLL
\param icon16 Iconset for the action
\param icon22 Iconset for the action
\param menuText Text to be in the menus for this action
\param accel Accelerator QKeySequence
\param parent Parent of this action
\param extraInt extra int value
\param extraDouble extra double value
\param extraQString extra QString value
*/
ScrAction( ActionType aType,
const QString &menuText, QKeySequence accel, QObject *parent,
int extraInt = 0, double extraDouble = 0.0, QString extraQString = QString::null );
ScrAction( ActionType aType, const QPixmap & icon16, const QPixmap & icon22,
const QString &menuText, QKeySequence accel, QObject *parent,
int extraInt = 0, double extraDouble = 0.0, QString extraQString = QString::null );
/*!
\author Craig Bradney
\date Jan 2005
\brief Constructor for a normal action. Stores iconset.
\param icon Iconset for the action
\param menuText Text to be in the menus for this action
\param accel Accelerator QKeySequence
\param parent Parent of this action
*/
ScrAction( const QPixmap & icon16, const QPixmap & icon22, const QString & menuText, QKeySequence accel, QObject *parent );
/*!
\author Craig Bradney
\date Mar 2008
\brief Constructor for a Unicode action.
\param accel Accelerator QKeySequence
\param parent Parent of this action
\param extraInt extra int value
\param extraQString extra QString value
*/
ScrAction( QKeySequence accel, QObject *parent, int extraInt, QString extraQString);
~ScrAction();
/*!
\author Craig Bradney
\date Jan 2005
\brief Return the stored menuIndex as QActions cannot deal with these well
\retval int Index of menu the action was inserted into
*/
int getMenuIndex() const;
/*!
\author Craig Bradney
\date Jan 2005
\brief Return a copy of the menu text, without the &s, possibility to remove ellipses in future.
\retval QString Stripped copy of the menu text
*/
QString cleanMenuText();
void setToolTipFromTextAndShortcut();
/*!
\author Craig Bradney
\date Jan 2005
\brief Return true if action is a DLL
\retval bool True if action is from a DLL
*/
bool isDLLAction() const;
/*!
\author Craig Bradney
\date Jan 2005
\brief Return DLL ID if the action is from a DLL, otherwise return -1
\retval int DLL ID or -1
*/
int dllID() const;
/*!
* \author Craig Bradney
* \date Feb 2005
* \brief Connect the internal toggle connections. Fake toggle actions are toggle actions
* but we connect activated() only, eg itemLock. This means they can be setOn()
* to the status of an item's bool, eg isLocked(), without toggling anything.
*/
void setToggleAction(bool isToggle, bool fakeToggle=false);
/*!
\author Craig Bradney
\date Feb 2005
\brief Store the shortcut in a private variable as these must be removed in editmode
*/
void saveShortcut();
/*!
\author Craig Bradney
\date Feb 2005
\brief Restore the saved shortcut to be the active one
*/
void restoreShortcut();
/*!
\author Craig Bradney
\date Apr 2005
\brief Return the action data type
*/
ActionType actionType();
/*!
\author Craig Bradney
\date Apr 2005
\brief Return the action data of int action type
*/
int actionInt() const;
double actionDouble() const;
const QString actionQString();
void setActionQString(const QString &);
/*! \brief Set up text and menuText at the same time */
void setTexts(const QString &newText);//#9114, qt3-qt4 change of behaviour bug: , bool setTextToo = true);
public slots:
void toggle();
signals:
void triggeredData(int);
void triggeredData(double);
void triggeredData(QString);
void triggeredData(ScribusDoc*);
void triggeredData(QWidget*, ScribusDoc*);
void toggledData(bool, int);
void toggledData(bool, double);
void toggledData(bool, QString);
void triggeredUnicodeShortcut(const QString&, int);
protected:
void initScrAction();
int menuIndex;
int pluginID;
int windowID;
int layerID;
int _dataInt;
double _dataDouble;
QString _dataQString;
ActionType _actionType;
QMenu *popupMenuAddedTo;
QKeySequence savedKeySequence;
bool shortcutSaved;
bool fakeToggle;
/*!
\author Craig Bradney
\date Jan 2005
\brief Overridden addedTo QPopupmenu based function to save a pointer to the QPopupMenu we are adding to.
\param index The saved index within the QPopupMenu
\param menu The menu we are adding this action to
*/
void addedTo( int index, QMenu * menu );
private slots:
/*!
\author Craig Bradney
\date Jan 2005
\brief This passed the triggered() action signal in and back out but with some data, easier than overriding menu and menu bar classes for now.
*/
void triggeredToTriggeredData();
/*!
\author Craig Bradney
\date Jan 2005
\brief This passed the toggled() action signal in and back out but with some data, easier than overriding menu and menu bar classes for now.
\param ison true if toggled = on
*/
void toggledToToggledData(bool ison);
};
#endif
|
