summaryrefslogtreecommitdiffstats
path: root/tdeui/klineeditdlg.h
diff options
context:
space:
mode:
Diffstat (limited to 'tdeui/klineeditdlg.h')
-rw-r--r--tdeui/klineeditdlg.h127
1 files changed, 127 insertions, 0 deletions
diff --git a/tdeui/klineeditdlg.h b/tdeui/klineeditdlg.h
new file mode 100644
index 000000000..ac8d834e4
--- /dev/null
+++ b/tdeui/klineeditdlg.h
@@ -0,0 +1,127 @@
+/* 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__
+
+// #include <tqt.h>
+
+#include <kdialogbase.h>
+
+class KLineEdit;
+class TQValidator;
+
+/**
+ * @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
+ * TQValidator 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 TQValidator that
+ * always returns Acceptable, e.g. TQRegExpValidator 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 TQString& _text, const TQString& _value, TQWidget *parent ) KDE_DEPRECATED;
+ virtual ~KLineEditDlg();
+
+ /**
+ * @return the value the user entered
+ */
+ TQString 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 TQString getText(const TQString &text, const TQString& value,
+ bool *ok, TQWidget *parent, TQValidator *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 TQString getText(const TQString &caption, const TQString &text,
+ const TQString& value=TQString::null,
+ bool *ok=0, TQWidget *parent=0,
+ TQValidator *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 TQValidator.
+ */
+ void slotTextChanged( const TQString& );
+
+protected:
+ /**
+ * The line edit widget
+ */
+ KLineEdit *edit;
+protected:
+ virtual void virtual_hook( int id, void* data );
+private:
+ class KLineEditDlgPrivate;
+ KLineEditDlgPrivate* d;
+};
+
+#endif