summaryrefslogtreecommitdiffabout
path: root/libkdepim/kprefswidget.h
Unidiff
Diffstat (limited to 'libkdepim/kprefswidget.h') (more/less context) (ignore whitespace changes)
-rw-r--r--libkdepim/kprefswidget.h1
1 files changed, 1 insertions, 0 deletions
diff --git a/libkdepim/kprefswidget.h b/libkdepim/kprefswidget.h
index 8a24515..8543a39 100644
--- a/libkdepim/kprefswidget.h
+++ b/libkdepim/kprefswidget.h
@@ -1,221 +1,222 @@
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// $Id$ 23// $Id$
24 24
25#ifndef _KPREFSWIDGET_H 25#ifndef _KPREFSWIDGET_H
26#define _KPREFSWIDGET_H 26#define _KPREFSWIDGET_H
27 27
28#include <qptrlist.h> 28#include <qptrlist.h>
29#include <qlineedit.h> 29#include <qlineedit.h>
30#include <qpushbutton.h>
30 31
31#include <qwidget.h> 32#include <qwidget.h>
32 33
33class KPrefs; 34class KPrefs;
34 35
35class KColorButton; 36class KColorButton;
36class QCheckBox; 37class QCheckBox;
37class QLabel; 38class QLabel;
38class QSpinBox; 39class QSpinBox;
39class QButtonGroup; 40class QButtonGroup;
40 41
41/** 42/**
42 @short Base class for widgets used by @ref KPrefsDialog. 43 @short Base class for widgets used by @ref KPrefsDialog.
43 @author Cornelius Schumacher 44 @author Cornelius Schumacher
44 @see KPrefsDialog 45 @see KPrefsDialog
45 46
46 This class provides the interface for the preferences widgets used by 47 This class provides the interface for the preferences widgets used by
47 KPrefsDialog. 48 KPrefsDialog.
48*/ 49*/
49class KPrefsWid : public QObject 50class KPrefsWid : public QObject
50{ 51{
51 Q_OBJECT 52 Q_OBJECT
52 public: 53 public:
53 /** 54 /**
54 This function is called to read value of the setting from the 55 This function is called to read value of the setting from the
55 stored configuration and display it in the widget. 56 stored configuration and display it in the widget.
56 */ 57 */
57 virtual void readConfig() = 0; 58 virtual void readConfig() = 0;
58 /** 59 /**
59 This function is called to write the current setting of the widget to the 60 This function is called to write the current setting of the widget to the
60 stored configuration. 61 stored configuration.
61 */ 62 */
62 virtual void writeConfig() = 0; 63 virtual void writeConfig() = 0;
63 64
64 //connect to this signal if you want to be notified of changes 65 //connect to this signal if you want to be notified of changes
65 signals: 66 signals:
66 void modified(); 67 void modified();
67 68
68}; 69};
69 70
70/** 71/**
71 @short Widget for bool settings in @ref KPrefsDialog. 72 @short Widget for bool settings in @ref KPrefsDialog.
72 73
73 This class provides a widget for configuring bool values. It is meant to be 74 This class provides a widget for configuring bool values. It is meant to be
74 used by KPrefsDialog. The user is responsible for the layout management. 75 used by KPrefsDialog. The user is responsible for the layout management.
75*/ 76*/
76class KPrefsWidBool : public KPrefsWid 77class KPrefsWidBool : public KPrefsWid
77{ 78{
78 public: 79 public:
79 /** 80 /**
80 Create a bool widget consisting of a QCheckbox. 81 Create a bool widget consisting of a QCheckbox.
81 82
82 @param text Text of QCheckBox. 83 @param text Text of QCheckBox.
83 @param reference Pointer to variable read and written by this widget. 84 @param reference Pointer to variable read and written by this widget.
84 @param parent Parent widget. 85 @param parent Parent widget.
85 */ 86 */
86 KPrefsWidBool(const QString &text,bool *reference,QWidget *parent); 87 KPrefsWidBool(const QString &text,bool *reference,QWidget *parent);
87 88
88 /** 89 /**
89 Return the QCheckbox used by this widget. 90 Return the QCheckbox used by this widget.
90 */ 91 */
91 QCheckBox *checkBox(); 92 QCheckBox *checkBox();
92 93
93 void readConfig(); 94 void readConfig();
94 void writeConfig(); 95 void writeConfig();
95 96
96 private: 97 private:
97 bool *mReference; 98 bool *mReference;
98 99
99 QCheckBox *mCheck; 100 QCheckBox *mCheck;
100}; 101};
101 102
102/** 103/**
103 @short Widget for time settings in @ref KPrefsDialog. 104 @short Widget for time settings in @ref KPrefsDialog.
104 105
105 This class provides a widget for configuring time values. It is meant to be 106 This class provides a widget for configuring time values. It is meant to be
106 used by KPrefsDialog. The user is responsible for the layout management. 107 used by KPrefsDialog. The user is responsible for the layout management.
107*/ 108*/
108class KPrefsWidTime : public KPrefsWid 109class KPrefsWidTime : public KPrefsWid
109{ 110{
110 public: 111 public:
111 /** 112 /**
112 Create a time widget consisting of a label and a spinbox. 113 Create a time widget consisting of a label and a spinbox.
113 114
114 @param text Text of Label. 115 @param text Text of Label.
115 @param reference Pointer to variable read and written by this widget. 116 @param reference Pointer to variable read and written by this widget.
116 @param parent Parent widget. 117 @param parent Parent widget.
117 */ 118 */
118 KPrefsWidTime(const QString &text,int *reference,QWidget *parent); 119 KPrefsWidTime(const QString &text,int *reference,QWidget *parent);
119 120
120 /** 121 /**
121 Return QLabel used by this widget. 122 Return QLabel used by this widget.
122 */ 123 */
123 QLabel *label(); 124 QLabel *label();
124 /** 125 /**
125 Return QSpinBox used by this widget. 126 Return QSpinBox used by this widget.
126 */ 127 */
127 QSpinBox *spinBox(); 128 QSpinBox *spinBox();
128 129
129 void readConfig(); 130 void readConfig();
130 void writeConfig(); 131 void writeConfig();
131 132
132 private: 133 private:
133 int *mReference; 134 int *mReference;
134 135
135 QLabel *mLabel; 136 QLabel *mLabel;
136 QSpinBox *mSpin; 137 QSpinBox *mSpin;
137}; 138};
138 139
139/** 140/**
140 @short Widget for color settings in @ref KPrefsDialog. 141 @short Widget for color settings in @ref KPrefsDialog.
141 142
142 This class provides a widget for configuring color values. It is meant to be 143 This class provides a widget for configuring color values. It is meant to be
143 used by KPrefsDialog. The user is responsible for the layout management. 144 used by KPrefsDialog. The user is responsible for the layout management.
144*/ 145*/
145class KPrefsWidColor : public KPrefsWid 146class KPrefsWidColor : public KPrefsWid
146{ 147{
147 public: 148 public:
148 /** 149 /**
149 Create a color widget consisting of a test field and a button for opening 150 Create a color widget consisting of a test field and a button for opening
150 a color dialog. 151 a color dialog.
151 152
152 @param text Text of button. 153 @param text Text of button.
153 @param reference Pointer to variable read and written by this widget. 154 @param reference Pointer to variable read and written by this widget.
154 @param parent Parent widget. 155 @param parent Parent widget.
155 */ 156 */
156 KPrefsWidColor(const QString &text,QColor *reference,QWidget *parent); 157 KPrefsWidColor(const QString &text,QColor *reference,QWidget *parent);
157 /** 158 /**
158 Destruct color setting widget. 159 Destruct color setting widget.
159 */ 160 */
160 ~KPrefsWidColor(); 161 ~KPrefsWidColor();
161 162
162 /** 163 /**
163 Return QLabel for the button 164 Return QLabel for the button
164 */ 165 */
165 QLabel *label(); 166 QLabel *label();
166 /** 167 /**
167 Return button opening the color dialog. 168 Return button opening the color dialog.
168 */ 169 */
169 KColorButton *button(); 170 KColorButton *button();
170 171
171 void readConfig(); 172 void readConfig();
172 void writeConfig(); 173 void writeConfig();
173 174
174 private: 175 private:
175 QColor *mReference; 176 QColor *mReference;
176 177
177 QLabel *mLabel; 178 QLabel *mLabel;
178 KColorButton *mButton; 179 KColorButton *mButton;
179}; 180};
180 181
181/** 182/**
182 @short Widget for font settings in @ref KPrefsDialog. 183 @short Widget for font settings in @ref KPrefsDialog.
183 184
184 This class provides a widget for configuring font values. It is meant to be 185 This class provides a widget for configuring font values. It is meant to be
185 used by KPrefsDialog. The user is responsible for the layout management. 186 used by KPrefsDialog. The user is responsible for the layout management.
186*/ 187*/
187class KPrefsWidFont : public KPrefsWid 188class KPrefsWidFont : public KPrefsWid
188{ 189{
189 Q_OBJECT 190 Q_OBJECT
190 public: 191 public:
191 /** 192 /**
192 Create a font widget consisting of a test field and a button for opening 193 Create a font widget consisting of a test field and a button for opening
193 a font dialog. 194 a font dialog.
194 195
195 @param label Text of label. 196 @param label Text of label.
196 @param reference Pointer to variable read and written by this widget. 197 @param reference Pointer to variable read and written by this widget.
197 @param parent Parent widget. 198 @param parent Parent widget.
198 */ 199 */
199 KPrefsWidFont(const QString &sampleText,const QString &labelText, 200 KPrefsWidFont(const QString &sampleText,const QString &labelText,
200 QFont *reference,QWidget *parent); 201 QFont *reference,QWidget *parent);
201 /** 202 /**
202 Destruct font setting widget. 203 Destruct font setting widget.
203 */ 204 */
204 ~KPrefsWidFont(); 205 ~KPrefsWidFont();
205 206
206 /** 207 /**
207 Return label. 208 Return label.
208 */ 209 */
209 QLabel *label(); 210 QLabel *label();
210 /** 211 /**
211 Return QFrame used as preview field. 212 Return QFrame used as preview field.
212 */ 213 */
213 QLabel *preview(); 214 QLabel *preview();
214 /** 215 /**
215 Return button opening the font dialog. 216 Return button opening the font dialog.
216 */ 217 */
217 QPushButton *button(); 218 QPushButton *button();
218 219
219 void readConfig(); 220 void readConfig();
220 void writeConfig(); 221 void writeConfig();
221 222