• Skip to content
  • Skip to link menu
KDE API Reference
  • KDE API Reference
  • kdelibs API Reference
  • KDE Home
  • Contact Us
 

KDEUI

Public Member Functions | Properties | List of all members
KStringListValidator Class Reference

#include <kstringvalidator.h>

Inheritance diagram for KStringListValidator:
Inheritance graph
[legend]

Public Member Functions

 KStringListValidator (const QStringList &list=QStringList(), bool rejecting=true, bool fixupEnabled=false, QObject *parent=0)
 
 ~KStringListValidator ()
 
virtual void fixup (QString &input) const
 
bool isFixupEnabled () const
 
bool isRejecting () const
 
void setFixupEnabled (bool fixupEnabled)
 
void setRejecting (bool rejecting)
 
void setStringList (const QStringList &list)
 
QStringList stringList () const
 
virtual State validate (QString &input, int &pos) const
 
- Public Member Functions inherited from QValidator
 QValidator (QObject *parent)
 
 QValidator (QObject *parent, const char *name)
 
 ~QValidator ()
 
QLocale locale () const
 
void setLocale (const QLocale &locale)
 
virtual State validate (QString &input, int &pos) const =0
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
 QObject (QObject *parent, const char *name)
 
virtual  ~QObject ()
 
bool blockSignals (bool block)
 
QObject * child (const char *objName, const char *inheritsClass, bool recursiveSearch) const
 
const QObjectList & children () const
 
const char * className () const
 
bool connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
 
void deleteLater ()
 
void destroyed (QObject *obj)
 
bool disconnect (const QObject *receiver, const char *method)
 
bool disconnect (const char *signal, const QObject *receiver, const char *method)
 
void dumpObjectInfo ()
 
void dumpObjectTree ()
 
QList< QByteArray > dynamicPropertyNames () const
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
T findChild (const QString &name) const
 
QList< T > findChildren (const QRegExp &regExp) const
 
QList< T > findChildren (const QString &name) const
 
bool inherits (const char *className) const
 
void insertChild (QObject *object)
 
void installEventFilter (QObject *filterObj)
 
bool isA (const char *className) const
 
bool isWidgetType () const
 
void killTimer (int id)
 
virtual const QMetaObject * metaObject () const
 
void moveToThread (QThread *targetThread)
 
const char * name () const
 
const char * name (const char *defaultName) const
 
QString objectName () const
 
QObject * parent () const
 
QVariant property (const char *name) const
 
void removeChild (QObject *object)
 
void removeEventFilter (QObject *obj)
 
void setName (const char *name)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const char *name, const QVariant &value)
 
bool signalsBlocked () const
 
int startTimer (int interval)
 
QThread * thread () const
 

Properties

bool fixupEnabled
 
bool rejecting
 
QStringList stringList
 
- Properties inherited from QObject
 objectName
 

Additional Inherited Members

- Static Public Member Functions inherited from QObject
bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
 
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 
- Protected Member Functions inherited from QObject
bool checkConnectArgs (const char *signal, const QObject *object, const char *method)
 
virtual void childEvent (QChildEvent *event)
 
virtual void connectNotify (const char *signal)
 
virtual void customEvent (QEvent *event)
 
virtual void disconnectNotify (const char *signal)
 
int receivers (const char *signal) const
 
QObject * sender () const
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *event)
 
- Static Protected Member Functions inherited from QObject
QByteArray normalizeSignalSlot (const char *signalSlot)
 

Detailed Description

A QValidator to (dis)allow certain strings.

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.

Author
Marc Mutz mutz@.nosp@m.kde..nosp@m.org

Definition at line 60 of file kstringvalidator.h.

Constructor & Destructor Documentation

KStringListValidator::KStringListValidator ( const QStringList &  list = QStringList(),
bool  rejecting = true,
bool  fixupEnabled = false,
QObject *  parent = 0 
)
explicit

Creates a new string validator.

Parameters
listThe list of strings to (dis)allow.
rejectingSelects the validator's mode (rejecting: true; accepting: false)
fixupEnabledSelects whether to fix strings or not.
parentPassed to lower level constructor.

Definition at line 35 of file kstringvalidator.cpp.

KStringListValidator::~KStringListValidator ( )

Destroys the string validator.

Definition at line 45 of file kstringvalidator.cpp.

Member Function Documentation

void KStringListValidator::fixup ( QString &  input) const
virtual

Reimplemented from.

See also
QValidator.

Reimplemented from QValidator.

Definition at line 71 of file kstringvalidator.cpp.

bool KStringListValidator::isFixupEnabled ( ) const

Returns whether the fixup flag is set.

Definition at line 99 of file kstringvalidator.cpp.

bool KStringListValidator::isRejecting ( ) const

Returns whether the string validator is in rejecting mode.

Definition at line 89 of file kstringvalidator.cpp.

void KStringListValidator::setFixupEnabled ( bool  fixupEnabled)

Sets the fixup flag.

If enabled, wrong input is corrected automatically.

Definition at line 94 of file kstringvalidator.cpp.

void KStringListValidator::setRejecting ( bool  rejecting)

Sets whether the string validator is in rejecting mode or not.

If in rejecting mode, the strings from

See also
stringList are not allowed to appear in the validation string.

Definition at line 84 of file kstringvalidator.cpp.

void KStringListValidator::setStringList ( const QStringList &  list)

Sets the.

Parameters
listof string which is used as black or white list, depending on the rejecting mode (
See also
isRejecting()).

Definition at line 104 of file kstringvalidator.cpp.

QStringList KStringListValidator::stringList ( ) const

Returns the string list of the validator.

QValidator::State KStringListValidator::validate ( QString &  input,
int &  pos 
) const
virtual

Reimplemented from.

See also
QValidator.

Definition at line 50 of file kstringvalidator.cpp.

Property Documentation

bool KStringListValidator::fixupEnabled
readwrite

Definition at line 65 of file kstringvalidator.h.

bool KStringListValidator::rejecting
readwrite

Definition at line 64 of file kstringvalidator.h.

QStringList KStringListValidator::stringList
readwrite

Definition at line 63 of file kstringvalidator.h.


The documentation for this class was generated from the following files:
  • kstringvalidator.h
  • kstringvalidator.cpp
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Mon Jun 22 2020 13:24:03 by doxygen 1.8.7 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

KDEUI

Skip menu "KDEUI"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Modules
  • Related Pages

kdelibs API Reference

Skip menu "kdelibs API Reference"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDEWebKit
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • KPty
  • Kross
  • KUnitConversion
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver

Search



Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal