summaryrefslogtreecommitdiffstats
path: root/kdeui/klineeditdlg.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commitce4a32fe52ef09d8f5ff1dd22c001110902b60a2 (patch)
tree5ac38a06f3dde268dc7927dc155896926aaf7012 /kdeui/klineeditdlg.h
downloadtdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.tar.gz
tdelibs-ce4a32fe52ef09d8f5ff1dd22c001110902b60a2.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kdeui/klineeditdlg.h')
-rw-r--r--kdeui/klineeditdlg.h125
1 files changed, 125 insertions, 0 deletions
diff --git a/kdeui/klineeditdlg.h b/kdeui/klineeditdlg.h
new file mode 100644
index 000000000..e5d0d3302
--- /dev/null
+++ b/kdeui/klineeditdlg.h
@@ -0,0 +1,125 @@
+/* This file is part of the KDE libraries
+
+ Copyright (C) 1999 Preston Brown <pbrown@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; see the file COPYING.LIB. If not, write to
+ the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ Boston, MA 02110-1301, USA.
+*/
+#ifndef __klineeditdlg_h__
+#define __klineeditdlg_h__
+
+class KLineEdit;
+class QValidator;
+
+#include <kdialogbase.h>
+
+/**
+ * @deprecated
+ * Please use KInputDialog instead.
+ *
+ * Dialog for user to enter a single line of text.
+ *
+ * @version $Id$
+ * @author David Faure <faure@kde.org>, layout management by Preston Brown <pbrown@kde.org>
+ */
+
+class KDEUI_EXPORT_DEPRECATED KLineEditDlg : public KDialogBase
+{
+ Q_OBJECT
+public:
+ /**
+ * Create a dialog that asks for a single line of text. _value is
+ * the initial value of the line. _text appears as label on top of
+ * the entry box. If the internal line edit has an associated
+ * QValidator set, the OK button is disabled as long as the
+ * validator doesn't return Acceptable. If there's no validator, the
+ * OK button is enabled whenever the line edit isn't empty.
+ *
+ * If you want to accept empty input, make a trivial QValidator that
+ * always returns Acceptable, e.g. QRegExpValidator with a
+ * regexp of ".*".
+ *
+ * @param _text Text of the label
+ * @param _value Initial value of the inputline
+ * @param parent Parent widget for the line edit dialog
+ */
+ KLineEditDlg( const QString& _text, const QString& _value, QWidget *parent ) KDE_DEPRECATED;
+ virtual ~KLineEditDlg();
+
+ /**
+ * @return the value the user entered
+ */
+ QString text() const;
+
+ /**
+ * @return the line edit widget
+ */
+ KLineEdit *lineEdit() const { return edit; }
+
+ /**
+ * Static convenience function to get a textual input from the user.
+ *
+ * @param text Text of the label
+ * @param value Initial value of the inputline
+ * @param ok this bool will be set to true if user pressed "Ok"
+ * @param validator Validator to be stuffed into the line edit.
+ * @param parent The parent widget
+ */
+ static QString getText(const QString &text, const QString& value,
+ bool *ok, QWidget *parent, QValidator *validator=0 ) KDE_DEPRECATED;
+
+ /**
+ * Static convenience function to get a textual input from the user.
+ * This method includes a caption, and has (almost) the same API as QInputDialog::getText
+ * (no echo mode, we have KPasswordDialog).
+ *
+ * @param caption Caption of the dialog
+ * @param text Text of the label
+ * @param value Initial value of the inputline
+ * @param ok this bool will be set to true if user pressed "Ok"
+ * @param parent The parent widget for this text input dialog
+ * @param validator Validator to be stuffed into the line edit.
+ */
+ static QString getText(const QString &caption, const QString &text,
+ const QString& value=QString::null,
+ bool *ok=0, QWidget *parent=0,
+ QValidator *validator=0) KDE_DEPRECATED;
+
+public slots:
+ /**
+ * Clears the edit widget
+ */
+ void slotClear();
+
+protected slots:
+ /**
+ * Enables and disables the OK button depending on the state
+ * returned by the lineedit's QValidator.
+ */
+ void slotTextChanged( const QString& );
+
+protected:
+ /**
+ * The line edit widget
+ */
+ KLineEdit *edit;
+protected:
+ virtual void virtual_hook( int id, void* data );
+private:
+ class KLineEditDlgPrivate;
+ KLineEditDlgPrivate* d;
+};
+
+#endif