-rw-r--r-- | libkdepim/kprefsdialog.h | 7 |
1 files changed, 3 insertions, 4 deletions
diff --git a/libkdepim/kprefsdialog.h b/libkdepim/kprefsdialog.h index ad13b78..efcb86a 100644 --- a/libkdepim/kprefsdialog.h +++ b/libkdepim/kprefsdialog.h | |||
@@ -1,446 +1,445 @@ | |||
1 | /* | 1 | /* |
2 | This file is part of KOrganizer. | 2 | This file is part of KOrganizer. |
3 | Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org> | 3 | Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org> |
4 | 4 | ||
5 | This program is free software; you can redistribute it and/or modify | 5 | This program is free software; you can redistribute it and/or modify |
6 | it under the terms of the GNU General Public License as published by | 6 | it under the terms of the GNU General Public License as published by |
7 | the Free Software Foundation; either version 2 of the License, or | 7 | the Free Software Foundation; either version 2 of the License, or |
8 | (at your option) any later version. | 8 | (at your option) any later version. |
9 | 9 | ||
10 | This program is distributed in the hope that it will be useful, | 10 | This program is distributed in the hope that it will be useful, |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | 11 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | 12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
13 | GNU General Public License for more details. | 13 | GNU General Public License for more details. |
14 | 14 | ||
15 | You should have received a copy of the GNU General Public License | 15 | You should have received a copy of the GNU General Public License |
16 | along with this program; if not, write to the Free Software | 16 | along with this program; if not, write to the Free Software |
17 | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. | 17 | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
18 | 18 | ||
19 | As a special exception, permission is given to link this program | 19 | As a special exception, permission is given to link this program |
20 | with any edition of Qt, and distribute the resulting executable, | 20 | with any edition of Qt, and distribute the resulting executable, |
21 | without including the source code for Qt in the source distribution. | 21 | without including the source code for Qt in the source distribution. |
22 | */ | 22 | */ |
23 | #ifndef _KPREFSDIALOG_H | 23 | #ifndef _KPREFSDIALOG_H |
24 | #define _KPREFSDIALOG_H | 24 | #define _KPREFSDIALOG_H |
25 | // $Id$ | 25 | // $Id$ |
26 | 26 | ||
27 | #include <qptrlist.h> | 27 | #include <qptrlist.h> |
28 | #include <qlineedit.h> | 28 | #include <qlineedit.h> |
29 | 29 | ||
30 | #include <kdialogbase.h> | 30 | #include <kdialogbase.h> |
31 | 31 | ||
32 | class KPrefs; | 32 | class KPrefs; |
33 | class KPrefsDialog; | 33 | class KPrefsDialog; |
34 | 34 | ||
35 | class KColorButton; | 35 | class KColorButton; |
36 | class QCheckBox; | 36 | class QCheckBox; |
37 | class QLabel; | 37 | class QLabel; |
38 | class QSpinBox; | 38 | class QSpinBox; |
39 | class QButtonGroup; | 39 | class QButtonGroup; |
40 | 40 | ||
41 | /** | 41 | /** |
42 | @short Base class for widgets used by @ref KPrefsDialog. | 42 | @short Base class for widgets used by @ref KPrefsDialog. |
43 | @author Cornelius Schumacher | 43 | @author Cornelius Schumacher |
44 | @see KPrefsDialog | 44 | @see KPrefsDialog |
45 | 45 | ||
46 | This class provides the interface for the preferences widgets used by | 46 | This class provides the interface for the preferences widgets used by |
47 | KPrefsDialog. | 47 | KPrefsDialog. |
48 | */ | 48 | */ |
49 | class KPrefsDialogWid | 49 | class KPrefsDialogWid : public QObject |
50 | { | 50 | { |
51 | public: | 51 | public: |
52 | /** | 52 | /** |
53 | This function is called to read value of the setting from the | 53 | This function is called to read value of the setting from the |
54 | stored configuration and display it in the widget. | 54 | stored configuration and display it in the widget. |
55 | */ | 55 | */ |
56 | virtual void readConfig() = 0; | 56 | virtual void readConfig() = 0; |
57 | /** | 57 | /** |
58 | This function is called to write the current setting of the widget to the | 58 | This function is called to write the current setting of the widget to the |
59 | stored configuration. | 59 | stored configuration. |
60 | */ | 60 | */ |
61 | virtual void writeConfig() = 0; | 61 | virtual void writeConfig() = 0; |
62 | }; | 62 | }; |
63 | 63 | ||
64 | /** | 64 | /** |
65 | @short Widget for bool settings in @ref KPrefsDialog. | 65 | @short Widget for bool settings in @ref KPrefsDialog. |
66 | 66 | ||
67 | This class provides a widget for configuring bool values. It is meant to be | 67 | This class provides a widget for configuring bool values. It is meant to be |
68 | used by KPrefsDialog. The user is responsible for the layout management. | 68 | used by KPrefsDialog. The user is responsible for the layout management. |
69 | */ | 69 | */ |
70 | class KPrefsDialogWidBool : public KPrefsDialogWid | 70 | class KPrefsDialogWidBool : public KPrefsDialogWid |
71 | { | 71 | { |
72 | public: | 72 | public: |
73 | /** | 73 | /** |
74 | Create a bool widget consisting of a QCheckbox. | 74 | Create a bool widget consisting of a QCheckbox. |
75 | 75 | ||
76 | @param text Text of QCheckBox. | 76 | @param text Text of QCheckBox. |
77 | @param reference Pointer to variable read and written by this widget. | 77 | @param reference Pointer to variable read and written by this widget. |
78 | @param parent Parent widget. | 78 | @param parent Parent widget. |
79 | */ | 79 | */ |
80 | KPrefsDialogWidBool(const QString &text,bool *reference,QWidget *parent); | 80 | KPrefsDialogWidBool(const QString &text,bool *reference,QWidget *parent); |
81 | 81 | ||
82 | /** | 82 | /** |
83 | Return the QCheckbox used by this widget. | 83 | Return the QCheckbox used by this widget. |
84 | */ | 84 | */ |
85 | QCheckBox *checkBox(); | 85 | QCheckBox *checkBox(); |
86 | 86 | ||
87 | void readConfig(); | 87 | void readConfig(); |
88 | void writeConfig(); | 88 | void writeConfig(); |
89 | 89 | ||
90 | private: | 90 | private: |
91 | bool *mReference; | 91 | bool *mReference; |
92 | 92 | ||
93 | QCheckBox *mCheck; | 93 | QCheckBox *mCheck; |
94 | }; | 94 | }; |
95 | 95 | ||
96 | /** | 96 | /** |
97 | @short Widget for time settings in @ref KPrefsDialog. | 97 | @short Widget for time settings in @ref KPrefsDialog. |
98 | 98 | ||
99 | This class provides a widget for configuring time values. It is meant to be | 99 | This class provides a widget for configuring time values. It is meant to be |
100 | used by KPrefsDialog. The user is responsible for the layout management. | 100 | used by KPrefsDialog. The user is responsible for the layout management. |
101 | */ | 101 | */ |
102 | class KPrefsDialogWidTime : public KPrefsDialogWid | 102 | class KPrefsDialogWidTime : public KPrefsDialogWid |
103 | { | 103 | { |
104 | public: | 104 | public: |
105 | /** | 105 | /** |
106 | Create a time widget consisting of a label and a spinbox. | 106 | Create a time widget consisting of a label and a spinbox. |
107 | 107 | ||
108 | @param text Text of Label. | 108 | @param text Text of Label. |
109 | @param reference Pointer to variable read and written by this widget. | 109 | @param reference Pointer to variable read and written by this widget. |
110 | @param parent Parent widget. | 110 | @param parent Parent widget. |
111 | */ | 111 | */ |
112 | KPrefsDialogWidTime(const QString &text,int *reference,QWidget *parent); | 112 | KPrefsDialogWidTime(const QString &text,int *reference,QWidget *parent); |
113 | 113 | ||
114 | /** | 114 | /** |
115 | Return QLabel used by this widget. | 115 | Return QLabel used by this widget. |
116 | */ | 116 | */ |
117 | QLabel *label(); | 117 | QLabel *label(); |
118 | /** | 118 | /** |
119 | Return QSpinBox used by this widget. | 119 | Return QSpinBox used by this widget. |
120 | */ | 120 | */ |
121 | QSpinBox *spinBox(); | 121 | QSpinBox *spinBox(); |
122 | 122 | ||
123 | void readConfig(); | 123 | void readConfig(); |
124 | void writeConfig(); | 124 | void writeConfig(); |
125 | 125 | ||
126 | private: | 126 | private: |
127 | int *mReference; | 127 | int *mReference; |
128 | 128 | ||
129 | QLabel *mLabel; | 129 | QLabel *mLabel; |
130 | QSpinBox *mSpin; | 130 | QSpinBox *mSpin; |
131 | }; | 131 | }; |
132 | 132 | ||
133 | /** | 133 | /** |
134 | @short Widget for color settings in @ref KPrefsDialog. | 134 | @short Widget for color settings in @ref KPrefsDialog. |
135 | 135 | ||
136 | This class provides a widget for configuring color values. It is meant to be | 136 | This class provides a widget for configuring color values. It is meant to be |
137 | used by KPrefsDialog. The user is responsible for the layout management. | 137 | used by KPrefsDialog. The user is responsible for the layout management. |
138 | */ | 138 | */ |
139 | class KPrefsDialogWidColor : public QObject, public KPrefsDialogWid | 139 | class KPrefsDialogWidColor : public KPrefsDialogWid |
140 | { | 140 | { |
141 | Q_OBJECT | ||
142 | public: | 141 | public: |
143 | /** | 142 | /** |
144 | Create a color widget consisting of a test field and a button for opening | 143 | Create a color widget consisting of a test field and a button for opening |
145 | a color dialog. | 144 | a color dialog. |
146 | 145 | ||
147 | @param text Text of button. | 146 | @param text Text of button. |
148 | @param reference Pointer to variable read and written by this widget. | 147 | @param reference Pointer to variable read and written by this widget. |
149 | @param parent Parent widget. | 148 | @param parent Parent widget. |
150 | */ | 149 | */ |
151 | KPrefsDialogWidColor(const QString &text,QColor *reference,QWidget *parent); | 150 | KPrefsDialogWidColor(const QString &text,QColor *reference,QWidget *parent); |
152 | /** | 151 | /** |
153 | Destruct color setting widget. | 152 | Destruct color setting widget. |
154 | */ | 153 | */ |
155 | ~KPrefsDialogWidColor(); | 154 | ~KPrefsDialogWidColor(); |
156 | 155 | ||
157 | /** | 156 | /** |
158 | Return QLabel for the button | 157 | Return QLabel for the button |
159 | */ | 158 | */ |
160 | QLabel *label(); | 159 | QLabel *label(); |
161 | /** | 160 | /** |
162 | Return button opening the color dialog. | 161 | Return button opening the color dialog. |
163 | */ | 162 | */ |
164 | KColorButton *button(); | 163 | KColorButton *button(); |
165 | 164 | ||
166 | void readConfig(); | 165 | void readConfig(); |
167 | void writeConfig(); | 166 | void writeConfig(); |
168 | 167 | ||
169 | private: | 168 | private: |
170 | QColor *mReference; | 169 | QColor *mReference; |
171 | 170 | ||
172 | QLabel *mLabel; | 171 | QLabel *mLabel; |
173 | KColorButton *mButton; | 172 | KColorButton *mButton; |
174 | }; | 173 | }; |
175 | 174 | ||
176 | /** | 175 | /** |
177 | @short Widget for font settings in @ref KPrefsDialog. | 176 | @short Widget for font settings in @ref KPrefsDialog. |
178 | 177 | ||
179 | This class provides a widget for configuring font values. It is meant to be | 178 | This class provides a widget for configuring font values. It is meant to be |
180 | used by KPrefsDialog. The user is responsible for the layout management. | 179 | used by KPrefsDialog. The user is responsible for the layout management. |
181 | */ | 180 | */ |
182 | class KPrefsDialogWidFont : public QObject, public KPrefsDialogWid | 181 | class KPrefsDialogWidFont : public KPrefsDialogWid |
183 | { | 182 | { |
184 | Q_OBJECT | 183 | Q_OBJECT |
185 | public: | 184 | public: |
186 | /** | 185 | /** |
187 | Create a font widget consisting of a test field and a button for opening | 186 | Create a font widget consisting of a test field and a button for opening |
188 | a font dialog. | 187 | a font dialog. |
189 | 188 | ||
190 | @param label Text of label. | 189 | @param label Text of label. |
191 | @param reference Pointer to variable read and written by this widget. | 190 | @param reference Pointer to variable read and written by this widget. |
192 | @param parent Parent widget. | 191 | @param parent Parent widget. |
193 | */ | 192 | */ |
194 | KPrefsDialogWidFont(const QString &sampleText,const QString &labelText, | 193 | KPrefsDialogWidFont(const QString &sampleText,const QString &labelText, |
195 | QFont *reference,QWidget *parent); | 194 | QFont *reference,QWidget *parent); |
196 | /** | 195 | /** |
197 | Destruct font setting widget. | 196 | Destruct font setting widget. |
198 | */ | 197 | */ |
199 | ~KPrefsDialogWidFont(); | 198 | ~KPrefsDialogWidFont(); |
200 | 199 | ||
201 | /** | 200 | /** |
202 | Return label. | 201 | Return label. |
203 | */ | 202 | */ |
204 | QLabel *label(); | 203 | QLabel *label(); |
205 | /** | 204 | /** |
206 | Return QFrame used as preview field. | 205 | Return QFrame used as preview field. |
207 | */ | 206 | */ |
208 | QLabel *preview(); | 207 | QLabel *preview(); |
209 | /** | 208 | /** |
210 | Return button opening the font dialog. | 209 | Return button opening the font dialog. |
211 | */ | 210 | */ |
212 | QPushButton *button(); | 211 | QPushButton *button(); |
213 | 212 | ||
214 | void readConfig(); | 213 | void readConfig(); |
215 | void writeConfig(); | 214 | void writeConfig(); |
216 | 215 | ||
217 | protected slots: | 216 | protected slots: |
218 | void selectFont(); | 217 | void selectFont(); |
219 | 218 | ||
220 | private: | 219 | private: |
221 | QFont *mReference; | 220 | QFont *mReference; |
222 | 221 | ||
223 | QLabel *mLabel; | 222 | QLabel *mLabel; |
224 | QLabel *mPreview; | 223 | QLabel *mPreview; |
225 | QPushButton *mButton; | 224 | QPushButton *mButton; |
226 | }; | 225 | }; |
227 | 226 | ||
228 | /** | 227 | /** |
229 | @short Widget for settings represented by a group of radio buttons in | 228 | @short Widget for settings represented by a group of radio buttons in |
230 | @ref KPrefsDialog. | 229 | @ref KPrefsDialog. |
231 | 230 | ||
232 | This class provides a widget for configuring selections. It is meant to be | 231 | This class provides a widget for configuring selections. It is meant to be |
233 | used by KPrefsDialog. The user is responsible for the layout management. The | 232 | used by KPrefsDialog. The user is responsible for the layout management. The |
234 | setting is interpreted as an int value, corresponding to the position of the | 233 | setting is interpreted as an int value, corresponding to the position of the |
235 | radio button. The position of the button is defined by the sequence of @ref | 234 | radio button. The position of the button is defined by the sequence of @ref |
236 | addRadio() calls, starting with 0. | 235 | addRadio() calls, starting with 0. |
237 | */ | 236 | */ |
238 | class KPrefsDialogWidRadios : public KPrefsDialogWid | 237 | class KPrefsDialogWidRadios : public KPrefsDialogWid |
239 | { | 238 | { |
240 | public: | 239 | public: |
241 | /** | 240 | /** |
242 | Create a widget for selection of an option. It consists of a box with | 241 | Create a widget for selection of an option. It consists of a box with |
243 | several radio buttons. | 242 | several radio buttons. |
244 | 243 | ||
245 | @param text Text of main box. | 244 | @param text Text of main box. |
246 | @param reference Pointer to variable read and written by this widget. | 245 | @param reference Pointer to variable read and written by this widget. |
247 | @param parent Parent widget. | 246 | @param parent Parent widget. |
248 | */ | 247 | */ |
249 | KPrefsDialogWidRadios(const QString &text,int *reference,QWidget *parent); | 248 | KPrefsDialogWidRadios(const QString &text,int *reference,QWidget *parent); |
250 | virtual ~KPrefsDialogWidRadios(); | 249 | virtual ~KPrefsDialogWidRadios(); |
251 | 250 | ||
252 | /** | 251 | /** |
253 | Add a radio button. | 252 | Add a radio button. |
254 | 253 | ||
255 | @param text Text of the button. | 254 | @param text Text of the button. |
256 | */ | 255 | */ |
257 | void addRadio(const QString &text); | 256 | void addRadio(const QString &text); |
258 | 257 | ||
259 | /** | 258 | /** |
260 | Return the box widget used by this widget. | 259 | Return the box widget used by this widget. |
261 | */ | 260 | */ |
262 | QButtonGroup *groupBox(); | 261 | QButtonGroup *groupBox(); |
263 | 262 | ||
264 | void readConfig(); | 263 | void readConfig(); |
265 | void writeConfig(); | 264 | void writeConfig(); |
266 | 265 | ||
267 | private: | 266 | private: |
268 | int *mReference; | 267 | int *mReference; |
269 | 268 | ||
270 | QButtonGroup *mBox; | 269 | QButtonGroup *mBox; |
271 | }; | 270 | }; |
272 | 271 | ||
273 | 272 | ||
274 | /** | 273 | /** |
275 | @short Widget for string settings in @ref KPrefsDialog. | 274 | @short Widget for string settings in @ref KPrefsDialog. |
276 | 275 | ||
277 | This class provides a widget for configuring string values. It is meant to be | 276 | This class provides a widget for configuring string values. It is meant to be |
278 | used by KPrefsDialog. The user is responsible for the layout management. | 277 | used by KPrefsDialog. The user is responsible for the layout management. |
279 | */ | 278 | */ |
280 | class KPrefsDialogWidString : public KPrefsDialogWid | 279 | class KPrefsDialogWidString : public KPrefsDialogWid |
281 | { | 280 | { |
282 | public: | 281 | public: |
283 | /** | 282 | /** |
284 | Create a string widget consisting of a test label and a line edit. | 283 | Create a string widget consisting of a test label and a line edit. |
285 | 284 | ||
286 | @param text Text of label. | 285 | @param text Text of label. |
287 | @param reference Pointer to variable read and written by this widget. | 286 | @param reference Pointer to variable read and written by this widget. |
288 | @param parent Parent widget. | 287 | @param parent Parent widget. |
289 | */ | 288 | */ |
290 | KPrefsDialogWidString(const QString &text,QString *reference,QWidget *parent,QLineEdit::EchoMode echomode=QLineEdit::Normal); | 289 | KPrefsDialogWidString(const QString &text,QString *reference,QWidget *parent,QLineEdit::EchoMode echomode=QLineEdit::Normal); |
291 | /** | 290 | /** |
292 | Destructor. | 291 | Destructor. |
293 | */ | 292 | */ |
294 | virtual ~KPrefsDialogWidString(); | 293 | virtual ~KPrefsDialogWidString(); |
295 | 294 | ||
296 | /** | 295 | /** |
297 | Return label used by this widget. | 296 | Return label used by this widget. |
298 | */ | 297 | */ |
299 | QLabel *label(); | 298 | QLabel *label(); |
300 | /** | 299 | /** |
301 | Return QLineEdit used by this widget. | 300 | Return QLineEdit used by this widget. |
302 | */ | 301 | */ |
303 | QLineEdit *lineEdit(); | 302 | QLineEdit *lineEdit(); |
304 | 303 | ||
305 | void readConfig(); | 304 | void readConfig(); |
306 | void writeConfig(); | 305 | void writeConfig(); |
307 | 306 | ||
308 | private: | 307 | private: |
309 | QString *mReference; | 308 | QString *mReference; |
310 | 309 | ||
311 | QLabel *mLabel; | 310 | QLabel *mLabel; |
312 | QLineEdit *mEdit; | 311 | QLineEdit *mEdit; |
313 | }; | 312 | }; |
314 | 313 | ||
315 | 314 | ||
316 | /** | 315 | /** |
317 | @short Base class for a preferences dialog. | 316 | @short Base class for a preferences dialog. |
318 | 317 | ||
319 | This class provides the framework for a preferences dialog. You have to | 318 | This class provides the framework for a preferences dialog. You have to |
320 | subclass it and add the code to create the actual configuration widgets and | 319 | subclass it and add the code to create the actual configuration widgets and |
321 | do the layout management. | 320 | do the layout management. |
322 | 321 | ||
323 | KPrefsDialog provides functions to add subclasses of @ref KPrefsDialogWid. For | 322 | KPrefsDialog provides functions to add subclasses of @ref KPrefsDialogWid. For |
324 | these widgets the reading, writing and setting to default values is handled | 323 | these widgets the reading, writing and setting to default values is handled |
325 | automatically. Custom widgets have to be handled in the functions @ref | 324 | automatically. Custom widgets have to be handled in the functions @ref |
326 | usrReadConfig() and @ref usrWriteConfig(). | 325 | usrReadConfig() and @ref usrWriteConfig(). |
327 | */ | 326 | */ |
328 | class KPrefsDialog : public KDialogBase | 327 | class KPrefsDialog : public KDialogBase |
329 | { | 328 | { |
330 | Q_OBJECT | 329 | Q_OBJECT |
331 | public: | 330 | public: |
332 | /** | 331 | /** |
333 | Create a KPrefsDialog for a KPrefs object. | 332 | Create a KPrefsDialog for a KPrefs object. |
334 | 333 | ||
335 | @param prefs KPrefs object used to access te configuration. | 334 | @param prefs KPrefs object used to access te configuration. |
336 | @param parent Parent widget. | 335 | @param parent Parent widget. |
337 | @param name Widget name. | 336 | @param name Widget name. |
338 | @param modal true, if dialog has to be modal, false for non-modal. | 337 | @param modal true, if dialog has to be modal, false for non-modal. |
339 | */ | 338 | */ |
340 | KPrefsDialog(KPrefs *prefs,QWidget *parent=0,char *name=0,bool modal=false); | 339 | KPrefsDialog(KPrefs *prefs,QWidget *parent=0,char *name=0,bool modal=false); |
341 | /** | 340 | /** |
342 | Destructor. | 341 | Destructor. |
343 | */ | 342 | */ |
344 | virtual ~KPrefsDialog(); | 343 | virtual ~KPrefsDialog(); |
345 | 344 | ||
346 | /** | 345 | /** |
347 | Register a custom KPrefsDialogWid object. | 346 | Register a custom KPrefsDialogWid object. |
348 | */ | 347 | */ |
349 | void addWid(KPrefsDialogWid *); | 348 | void addWid(KPrefsDialogWid *); |
350 | /** | 349 | /** |
351 | Register a @ref KPrefsDialogWidBool object. | 350 | Register a @ref KPrefsDialogWidBool object. |
352 | 351 | ||
353 | @param text Text of bool widget. | 352 | @param text Text of bool widget. |
354 | @param reference Reference to variable storing the setting. | 353 | @param reference Reference to variable storing the setting. |
355 | @param parent Parent widget. | 354 | @param parent Parent widget. |
356 | */ | 355 | */ |
357 | KPrefsDialogWidBool *addWidBool(const QString &text,bool *reference,QWidget *parent); | 356 | KPrefsDialogWidBool *addWidBool(const QString &text,bool *reference,QWidget *parent); |
358 | /** | 357 | /** |
359 | Register a @ref KPrefsDialogWidTime object. | 358 | Register a @ref KPrefsDialogWidTime object. |
360 | 359 | ||
361 | @param text Text of time widget. | 360 | @param text Text of time widget. |
362 | @param reference Reference to variable storing the setting. | 361 | @param reference Reference to variable storing the setting. |
363 | @param parent Parent widget. | 362 | @param parent Parent widget. |
364 | */ | 363 | */ |
365 | KPrefsDialogWidTime *addWidTime(const QString &text,int *reference,QWidget *parent); | 364 | KPrefsDialogWidTime *addWidTime(const QString &text,int *reference,QWidget *parent); |
366 | /** | 365 | /** |
367 | Register a @ref KPrefsDialogWidColor object. | 366 | Register a @ref KPrefsDialogWidColor object. |
368 | 367 | ||
369 | @param text Text of color widget. | 368 | @param text Text of color widget. |
370 | @param reference Reference to variable storing the setting. | 369 | @param reference Reference to variable storing the setting. |
371 | @param parent Parent widget. | 370 | @param parent Parent widget. |
372 | */ | 371 | */ |
373 | KPrefsDialogWidColor *addWidColor(const QString &text,QColor *reference,QWidget *parent); | 372 | KPrefsDialogWidColor *addWidColor(const QString &text,QColor *reference,QWidget *parent); |
374 | /** | 373 | /** |
375 | Register a @ref KPrefsDialogWidRadios object. | 374 | Register a @ref KPrefsDialogWidRadios object. |
376 | 375 | ||
377 | @param text Text of radio button box widget. | 376 | @param text Text of radio button box widget. |
378 | @param reference Reference to variable storing the setting. | 377 | @param reference Reference to variable storing the setting. |
379 | @param parent Parent widget. | 378 | @param parent Parent widget. |
380 | */ | 379 | */ |
381 | KPrefsDialogWidRadios *addWidRadios(const QString &text,int *reference,QWidget *parent); | 380 | KPrefsDialogWidRadios *addWidRadios(const QString &text,int *reference,QWidget *parent); |
382 | /** | 381 | /** |
383 | Register a @ref KPrefsDialogWidString object. | 382 | Register a @ref KPrefsDialogWidString object. |
384 | 383 | ||
385 | @param text Text of string widget. | 384 | @param text Text of string widget. |
386 | @param reference Reference to variable storing the setting. | 385 | @param reference Reference to variable storing the setting. |
387 | @param parent Parent widget. | 386 | @param parent Parent widget. |
388 | */ | 387 | */ |
389 | KPrefsDialogWidString *addWidString(const QString &text,QString *reference,QWidget *parent); | 388 | KPrefsDialogWidString *addWidString(const QString &text,QString *reference,QWidget *parent); |
390 | /** | 389 | /** |
391 | Register a password @ref KPrefsDialogWidString object, with echomode set to QLineEdit::Password. | 390 | Register a password @ref KPrefsDialogWidString object, with echomode set to QLineEdit::Password. |
392 | 391 | ||
393 | @param text Text of string widget. | 392 | @param text Text of string widget. |
394 | @param reference Reference to variable storing the setting. | 393 | @param reference Reference to variable storing the setting. |
395 | @param parent Parent widget. | 394 | @param parent Parent widget. |
396 | */ | 395 | */ |
397 | KPrefsDialogWidString *addWidPassword (const QString &text,QString *reference,QWidget *parent); | 396 | KPrefsDialogWidString *addWidPassword (const QString &text,QString *reference,QWidget *parent); |
398 | /** | 397 | /** |
399 | Register a @ref KPrefsDialogWidFont object. | 398 | Register a @ref KPrefsDialogWidFont object. |
400 | 399 | ||
401 | @param sampleText Sample text of font widget. | 400 | @param sampleText Sample text of font widget. |
402 | @param buttonText Button text of font widget. | 401 | @param buttonText Button text of font widget. |
403 | @param reference Reference to variable storing the setting. | 402 | @param reference Reference to variable storing the setting. |
404 | @param parent Parent widget. | 403 | @param parent Parent widget. |
405 | */ | 404 | */ |
406 | KPrefsDialogWidFont *addWidFont(const QString &sampleText,const QString &buttonText, | 405 | KPrefsDialogWidFont *addWidFont(const QString &sampleText,const QString &buttonText, |
407 | QFont *reference,QWidget *parent); | 406 | QFont *reference,QWidget *parent); |
408 | 407 | ||
409 | public slots: | 408 | public slots: |
410 | /** Set all widgets to default values. */ | 409 | /** Set all widgets to default values. */ |
411 | void setDefaults(); | 410 | void setDefaults(); |
412 | 411 | ||
413 | /** Read preferences from config file. */ | 412 | /** Read preferences from config file. */ |
414 | void readConfig(); | 413 | void readConfig(); |
415 | 414 | ||
416 | /** Write preferences to config file. */ | 415 | /** Write preferences to config file. */ |
417 | void writeConfig(); | 416 | void writeConfig(); |
418 | 417 | ||
419 | signals: | 418 | signals: |
420 | /** Emitted when the a changed configuration has been stored. */ | 419 | /** Emitted when the a changed configuration has been stored. */ |
421 | void configChanged(); | 420 | void configChanged(); |
422 | 421 | ||
423 | protected slots: | 422 | protected slots: |
424 | /** Apply changes to preferences */ | 423 | /** Apply changes to preferences */ |
425 | void slotApply(); | 424 | void slotApply(); |
426 | 425 | ||
427 | void accept(); | 426 | void accept(); |
428 | /** Accept changes to preferences and close dialog */ | 427 | /** Accept changes to preferences and close dialog */ |
429 | void slotOk(); | 428 | void slotOk(); |
430 | 429 | ||
431 | /** Set preferences to default values */ | 430 | /** Set preferences to default values */ |
432 | void slotDefault(); | 431 | void slotDefault(); |
433 | 432 | ||
434 | protected: | 433 | protected: |
435 | /** Implement this to read custom configuration widgets. */ | 434 | /** Implement this to read custom configuration widgets. */ |
436 | virtual void usrReadConfig() {} | 435 | virtual void usrReadConfig() {} |
437 | /** Implement this to write custom configuration widgets. */ | 436 | /** Implement this to write custom configuration widgets. */ |
438 | virtual void usrWriteConfig() {} | 437 | virtual void usrWriteConfig() {} |
439 | 438 | ||
440 | private: | 439 | private: |
441 | KPrefs *mPrefs; | 440 | KPrefs *mPrefs; |
442 | 441 | ||
443 | QPtrList<KPrefsDialogWid> mPrefsWids; | 442 | QPtrList<KPrefsDialogWid> mPrefsWids; |
444 | }; | 443 | }; |
445 | 444 | ||
446 | #endif | 445 | #endif |