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
|
/**********************************************************************
**
** $Id$
**
** Copyright (C) 1999 Glen Parker <glenebob@nwlink.com>
** Copyright (C) 2002 Marc Mutz <mutz@kde.org>
**
** This library is free software; you can redistribute it and/or
** modify it under the terms of the GNU Library General Public
** License as published by the Free Software Foundation; either
** version 2 of the License, or (at your option) any later version.
**
** This library 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; if not, write to the Free
** Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
**
*****************************************************************************/
#ifndef __KNUMVALIDATOR_H
#define __KNUMVALIDATOR_H
#include <qvalidator.h>
class QWidget;
class QString;
/**
* @ref QValidator for integers.
This can be used by @ref QLineEdit or subclass to provide validated
text entry. Can be provided with a base value (default is 10), to allow
the proper entry of hexadecimal, octal, or any other base numeric data.
@author Glen Parker <glenebob@nwlink.com>
@version 0.0.1
*/
class KIntValidator : public QValidator {
public:
/**
Constuctor. Also sets the base value.
*/
KIntValidator ( QWidget * parent, int base = 10, const char * name = 0 );
/**
* Constructor. Also sets the minimum, maximum, and numeric base values.
*/
KIntValidator ( int bottom, int top, QWidget * parent, int base = 10, const char * name = 0 );
/**
* Destructs the validator.
*/
virtual ~KIntValidator ();
/**
* Validates the text, and return the result. Does not modify the parameters.
*/
virtual State validate ( QString &, int & ) const;
/**
* Fixes the text if possible, providing a valid string. The parameter may be modified.
*/
virtual void fixup ( QString & ) const;
/**
* Sets the minimum and maximum values allowed.
*/
virtual void setRange ( int bottom, int top );
/**
* Sets the numeric base value.
*/
virtual void setBase ( int base );
/**
* Returns the current minimum value allowed.
*/
virtual int bottom () const;
/**
* Returns the current maximum value allowed.
*/
virtual int top () const;
/**
* Returns the current numeric base.
*/
virtual int base () const;
private:
int _base;
int _min;
int _max;
};
class KFloatValidatorPrivate;
/**
@obsolete Use @ref KDoubleValidator
@ref QValidator for floating point entry.
Extends the QValidator class to properly validate double numeric data.
This can be used by @ref QLineEdit or subclass to provide validated
text entry.
@author Glen Parker <glenebob@nwlink.com>
@version 0.0.1
*/
class KFloatValidator : public QValidator {
public:
/**
* Constructor.
*/
KFloatValidator ( QWidget * parent, const char * name = 0 );
/**
* Constructor. Also sets the minimum and maximum values.
*/
KFloatValidator ( double bottom, double top, QWidget * parent, const char * name = 0 );
/**
* Constructor. Sets the validator to be locale aware if @p localeAware is true.
*/
KFloatValidator ( double bottom, double top, bool localeAware, QWidget * parent, const char * name = 0 );
/**
* Destructs the validator.
*/
virtual ~KFloatValidator ();
/**
* Validates the text, and return the result. Does not modify the parameters.
*/
virtual State validate ( QString &, int & ) const;
/**
* Fixes the text if possible, providing a valid string. The parameter may be modified.
*/
virtual void fixup ( QString & ) const;
/**
* Sets the minimum and maximum value allowed.
*/
virtual void setRange ( double bottom, double top );
/**
* Returns the current minimum value allowed.
*/
virtual double bottom () const;
/**
* Returns the current maximum value allowed.
*/
virtual double top () const;
/**
* Sets the validator to be locale aware if @p is true. In this case, the
* character KLocale::decimalSymbol() from the global locale is recognized
* as decimal separator.
*/
void setAcceptLocalizedNumbers(bool b);
/**
* Returns true if the validator is locale aware.
* @see setAcceptLocalizedNumbers().
*/
bool acceptLocalizedNumbers() const;
private:
double _min;
double _max;
KFloatValidatorPrivate *d;
};
/**
KDoubleValidator extends @ref QDoubleValidator to be
locale-aware. That means that - subject to not being disabled -
@ref KLocale::decimalPoint(), @ref KLocale::thousandsSeparator()
and @ref KLocale::positiveSign() and @ref KLocale::negativeSign()
are respected.
@short A locale-aware @ref QDoubleValidator
@author Marc Mutz <mutz@kde.org>
@version $Id$
@see KIntValidator
@since 3.1
**/
class KDoubleValidator : public QDoubleValidator {
Q_OBJECT
Q_PROPERTY( bool acceptLocalizedNumbers READ acceptLocalizedNumbers WRITE setAcceptLocalizedNumbers )
public:
/** Constuct a locale-aware KDoubleValidator with default range
(whatever @ref QDoubleValidator uses for that) and parent @p
parent */
KDoubleValidator( QObject * parent, const char * name=0 );
/** Constuct a locale-aware KDoubleValidator for range [@p bottom,@p
top] and a precision of @p decimals decimals after the decimal
point. */
KDoubleValidator( double bottom, double top, int decimals,
QObject * parent, const char * name=0 );
/** Destructs the validator.
*/
virtual ~KDoubleValidator();
/** Overloaded for internal reasons. The API is not affected. */
virtual QValidator::State validate( QString & input, int & pos ) const;
/** @return whether localized numbers are accepted (default: true) */
bool acceptLocalizedNumbers() const;
/** Sets whether to accept localized numbers (default: true) */
void setAcceptLocalizedNumbers( bool accept );
private:
typedef QDoubleValidator base;
class Private;
Private * d;
};
#endif
|
