Public Methods
Protected Members
This validator allows you to accept only certain or to accept all
but certain strings.
When used in rejecting mode, accepts only strings not in the
stringlist. This mode is the default and comes in handy when asking
the user for a name of some listed entity. Set the list of already
used names to prevent the user from entering duplicate names.
When used in non-rejecting mode, accepts only strings that appear
in the stringlist. Use with care! From a user's point of view this
mode is hard to grasp.
This validator can also fix strings. In rejecting mode, a number
will be appended to the string until it is Acceptable. E.g. if
"foo" and "foo 1" are in the stringlist, then fixup will change
"foo" to "foo 2", provided "foo 2" isn't in the list of forbidden
strings.
In accepting mode, when the input starts with an Acceptable
substring, truncates to the longest Acceptable string. When the
input is the start of an Acceptable string, completes to the
shortest Acceptable string.
NOTE: fixup isn't yet implemented.
KStringListValidator ( const QStringList & list=QStringList(),
bool rejecting=true, bool fixupEnabled=false,
QObject * parent=0, const char * name=0 )
| KStringListValidator |
Construct a new validator.
Parameters:
| list | The list of strings to (dis)allow.
|
| rejecting | Selects the validator's mode
(rejecting: true; accepting: false)
|
| fixupEnabled | Selects whether to fix strings or not.
|
State validate ( QString & input, int & pos )
| validate |
[const virtual]
void fixup ( QString & input )
| fixup |
[const virtual]
void setRejecting ( bool rejecting )
| setRejecting |
bool isRejecting ()
| isRejecting |
[const]
void setFixupEnabled ( bool fixupEnabled )
| setFixupEnabled |
bool isFixupEnabled ()
| isFixupEnabled |
[const]
void setStringList ( const QStringList & list )
| setStringList |
[const]
[protected]
| bool mRejecting
| mRejecting |
[protected]
| bool mFixupEnabled
| mFixupEnabled |
[protected]
- Author: Marc Mutz
- Generated: dfaure on faure on Tue Apr 16 08:49:25 2002, using kdoc 2.0a53.