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
259
260
261
262
|
/*
This file is part of the Opie Project
Copyright (c) 2002 S. Prud'homme <prudhomme@laposte.net>
Dan Williams <williamsdr@acm.org>
=.
.=l.
.>+-=
_;:, .> :=|. This program is free software; you can
.> <`_, > . <= redistribute it and/or modify it under
:`=1 )Y*s>-.-- : the terms of the GNU Library General Public
.="- .-=="i, .._ License as published by the Free Software
- . .-<_> .<> Foundation; either version 2 of the License,
._= =} : or (at your option) any later version.
.%`+i> _;_.
.i_,=:_. -<s. 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
..}^=.= = ; Library General Public License for more
++= -. .` .: details.
: = ...= . :.=-
-. .:....=;==+<; You should have received a copy of the GNU
-_. . . )=. = Library General Public License along with
-- :-=` this library; see the file COPYING.LIB.
If not, write to the Free Software Foundation,
Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
#ifndef OCOLORPOPUPMENU_H
#define OCOLORPOPUPMENU_H
/* QT */
#include <qframe.h>
#include <qpopupmenu.h>
class QWidget;
class QGridLayout;
namespace Opie
{
/**
* @class OColorPanelButton
* @brief The OColorPanelButton class provides a button for color selection.
*
* @see OColorPopupMenu
*
* The OColorPanelButton class provides a button for color selection. The button
* is drawn with the desired color and no border. This class is used internally
* by the OColorPopupMenu class to displaying colors in its menu.
*/
class OColorPanelButton : public QFrame
{
Q_OBJECT
public:
/**
* @fn OColorPanelButton( const QColor& color, QWidget* parent = 0, const char* name = 0 )
* @brief Object constructor.
*
* @param color Desired color.
* @param parent Pointer to parent of this control.
* @param name Name of control.
*
* Constructs a new ColorPanelButton control with parent, name and desired color.
*/
OColorPanelButton(const QColor& color, QWidget* parent = 0, const char* name = 0);
/**
* @fn ~OColorPanelButton()
* @brief Object destructor.
*/
~OColorPanelButton();
/**
* @fn setActive( bool active )
* @brief Sets button selection state.
*
* @param active Boolean indicator of new button state.
*
* Changes button selection state. If button is selected, a highlighted border
* is drawn.
*/
void setActive(bool active);
/**
* @fn enterEvent( QEvent* e )
* @brief Reimplemented for internal reasons.
*
* @param e Event currently being processed.
*
* Reimplemented to ensure correct display of button based on whether it is
* active or not.
*/
void enterEvent(QEvent* e);
/**
* @fn leaveEvent( QEvent* e )
* @brief Reimplemented for internal reasons.
*
* @param e Event currently being processed.
*
* Reimplemented to ensure correct display of button based on whether it is
* active or not.
*/
void leaveEvent(QEvent* e);
/**
* @fn paintEvent( QPaintEvent* e )
* @brief Reimplemented for internal reasons.
*
* @param e Event currently being processed.
* @reimp
* Reimplemented to ensure correct display of button.
*/
void paintEvent(QPaintEvent* e);
/**
* @fn mouseReleaseEvent( QMouseEvent* e )
* @brief Slot executed when button is pressed.
*
* @param e Mouse event currently being processed.
*
* @see selected()
*
* This slot executes when the button has been pressed. It emits the selected
* signal as notification that it has been pressed.
*/
void mouseReleaseEvent(QMouseEvent* e);
signals:
/**
* @fn selected( const QColor& color )
* @brief Signal to indicate button has been pressed.
*
* @param color Button color.
*
* This signal is emitted when the button is pressed. It provides the color
* associated to this button.
*/
void selected(const QColor&);
private:
QColor m_color;
bool m_active : 1;
class ColorPanelButtonPrivate;
ColorPanelButtonPrivate *d;
};
/**
* @class OColorPopupMenu
* @brief The OColorPopupMenu class provides a small color selection
* popup menu.
*
* OColorPopupMenu is a derivation of TrollTech's QPopupMenu and provides
* a small color selection popup menu which can be attached to another control
* such as a toolbar button of menu item.
*
* The popup menu displays 30 default colors available in a grid, and also
* includes an option at the bottom to display a color selection dialog box for
* finer color control.
*/
class OColorPopupMenu : public QPopupMenu
{
Q_OBJECT
public:
/**
* @fn OColorPopupMenu( const QColor& color, QWidget* parent = 0, const char* name = 0 )
* @brief Object constructor.
*
* @param color Initial color selected in menu.
* @param parent Pointer to parent of this control.
* @param name Name of control.
*
* Constructs a new OColorPopupMenu control with parent, name and initial color selected.
*/
// FIXME add Wflags? -zecke
OColorPopupMenu( const QColor& color, QWidget* parent = 0, const char* name = 0 );
/**
* @fn ~OColorPopupMenu()
* @brief Object destructor.
*/
~OColorPopupMenu();
private:
class ColorPopupMenuPrivate;
ColorPopupMenuPrivate *d;
QColor m_color;
QWidget* colorPanel;
QGridLayout* colorLayout;
/**
* @fn addColor( const QColor& color, int row, int col )
* @brief Adds color selection option to popup menu.
*
* @param color Color to be displayed in menu.
* @param row Row where color is to appear in menu.
* @param col Column where color is to appear in menu.
*
* Adds a color selection option to popup menu. Used internally when
* initially constructing the menu control.
*/
void addColor( const QColor& color, int row, int col );
signals:
/**
* @fn colorSelected( const QColor& color )
* @brief Signal to indicate color chosen from the menu.
*
* @param color Color selected from the menu.
*
* This signal is emitted when a color has been selected either directly from
* the menu, or chosen from the color selection dialog.
*/
void colorSelected( const QColor& color );
protected slots:
/**
* @fn buttonSelected( const QColor& color )
* @brief Slot to process selected color.
*
* @param color Color selected from the menu.
*
* @see colorSelected()
*
* This slot executes when a color has been selected from the menu. It performs
* two functions:
* - Emit the colorSelected signal with the color selected.
* - Hide the menu.
*/
void buttonSelected( const QColor& color );
/**
* @fn moreColorClicked()
* @brief Slot to process display color selection dialog.
*
* @see colorSelected()
*
* This slot executes when the 'More...' option is selected at the bottom of the menu.
* It performs the following functions:
* - Constructs and executes a QColorDialog to allow finer color selection.
* - Emit the colorSelected signal with the color selected.
* - Hide the menu.
*/
void moreColorClicked();
};
};
#endif // COLORPOPUPMENUANEL_H
|
