.TH "KLineEditDlg" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdeui Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KLineEditDlg \- 
.SH SYNOPSIS
.br
.PP
\fC#include <klineeditdlg.h>\fP
.PP
Inherits \fBKDialogBase\fP.
.PP
.SS "Public Slots"

.in +1c
.ti -1c
.RI "void \fBslotClear\fP ()"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKLineEditDlg\fP (const \fBQString\fP &_text, const \fBQString\fP &_value, \fBQWidget\fP *parent) KDE_DEPRECATED"
.br
.ti -1c
.RI "\fBQString\fP \fBtext\fP () const "
.br
.ti -1c
.RI "\fBKLineEdit\fP * \fBlineEdit\fP () const "
.br
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "static \fBQString\fP \fBgetText\fP (const \fBQString\fP &text, const \fBQString\fP &value, bool *ok, \fBQWidget\fP *parent, \fBQValidator\fP *validator=0) KDE_DEPRECATED"
.br
.ti -1c
.RI "static \fBQString\fP \fBgetText\fP (const \fBQString\fP &caption, const \fBQString\fP &text, const \fBQString\fP &value=QString::null, bool *ok=0, \fBQWidget\fP *parent=0, \fBQValidator\fP *validator=0) KDE_DEPRECATED"
.br
.in -1c
.SS "Protected Slots"

.in +1c
.ti -1c
.RI "void \fBslotTextChanged\fP (const \fBQString\fP &)"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "virtual void \fBvirtual_hook\fP (int id, void *data)"
.br
.in -1c
.SS "Protected Attributes"

.in +1c
.ti -1c
.RI "\fBKLineEdit\fP * \fBedit\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
\fBDeprecated\fP
.RS 4
Please use \fBKInputDialog\fP instead. 
.RE
.PP
Dialog for user to enter a single line of text.
.PP
\fBVersion:\fP
.RS 4
\fBId\fP.RS 4
\fBklineeditdlg.h\fP 345070 2004-09-08 19:30:58Z staniek 
.RE
.PP
.RE
.PP
\fBAuthor:\fP
.RS 4
David Faure <faure@kde.org>, layout management by Preston Brown <pbrown@kde.org> 
.RE
.PP

.PP
Definition at line 38 of file klineeditdlg.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KLineEditDlg::KLineEditDlg (const \fBQString\fP & _text, const \fBQString\fP & _value, \fBQWidget\fP * parent)"
.PP
Create a dialog that asks for a single line of text. 
.PP
_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 \fBQValidator\fP 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.
.PP
If you want to accept empty input, make a trivial \fBQValidator\fP that always returns Acceptable, e.g. \fBQRegExpValidator\fP with a regexp of '.*'.
.PP
\fBParameters:\fP
.RS 4
\fI_text\fP Text of the label 
.br
\fI_value\fP Initial value of the inputline 
.br
\fIparent\fP Parent widget for the line edit dialog 
.RE
.PP

.PP
Definition at line 37 of file klineeditdlg.cpp.
.PP
References edit, KDialogBase::enableButton(), KDialogBase::enableButtonOK(), KDialogBase::plainPage(), QLineEdit::setSelection(), KLineEdit::setText(), QLineEdit::sizeHint(), slotClear(), slotTextChanged(), KDialog::spacingHint(), QLineEdit::text(), and KDialogBase::user1Clicked().
.SH "Member Function Documentation"
.PP 
.SS "\fBQString\fP KLineEditDlg::text () const"
.PP
\fBReturns:\fP
.RS 4
the value the user entered 
.RE
.PP

.PP
Definition at line 154 of file klineeditdlg.cpp.
.PP
References edit, and QLineEdit::text().
.PP
Referenced by getText(), and slotTextChanged().
.SS "\fBKLineEdit\fP* KLineEditDlg::lineEdit () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
the line edit widget 
.RE
.PP

.PP
Definition at line 69 of file klineeditdlg.h.
.PP
Referenced by getText().
.SS "\fBQString\fP KLineEditDlg::getText (const \fBQString\fP & text, const \fBQString\fP & value, bool * ok, \fBQWidget\fP * parent, \fBQValidator\fP * validator = \fC0\fP)\fC [static]\fP"
.PP
Static convenience function to get a textual input from the user. 
.PP
\fBParameters:\fP
.RS 4
\fItext\fP Text of the label 
.br
\fIvalue\fP Initial value of the inputline 
.br
\fIok\fP this bool will be set to true if user pressed 'Ok' 
.br
\fIvalidator\fP Validator to be stuffed into the line edit. 
.br
\fIparent\fP The parent widget 
.RE
.PP

.PP
Definition at line 159 of file klineeditdlg.cpp.
.PP
References QDialog::exec(), lineEdit(), QLineEdit::setValidator(), slotTextChanged(), and text().
.SS "\fBQString\fP KLineEditDlg::getText (const \fBQString\fP & caption, const \fBQString\fP & text, const \fBQString\fP & value = \fCQString::null\fP, bool * ok = \fC0\fP, \fBQWidget\fP * parent = \fC0\fP, \fBQValidator\fP * validator = \fC0\fP)\fC [static]\fP"
.PP
Static convenience function to get a textual input from the user. 
.PP
This method includes a caption, and has (almost) the same API as \fBQInputDialog::getText\fP (no echo mode, we have \fBKPasswordDialog\fP).
.PP
\fBParameters:\fP
.RS 4
\fIcaption\fP Caption of the dialog 
.br
\fItext\fP Text of the label 
.br
\fIvalue\fP Initial value of the inputline 
.br
\fIok\fP this bool will be set to true if user pressed 'Ok' 
.br
\fIparent\fP The parent widget for this text input dialog 
.br
\fIvalidator\fP Validator to be stuffed into the line edit. 
.RE
.PP

.PP
Definition at line 174 of file klineeditdlg.cpp.
.PP
References QDialog::exec(), lineEdit(), KDialog::setCaption(), QLineEdit::setValidator(), slotTextChanged(), and text().
.SS "void KLineEditDlg::slotClear ()\fC [slot]\fP"
.PP
Clears the edit widget. 
.PP
Definition at line 134 of file klineeditdlg.cpp.
.PP
References edit, and KLineEdit::setText().
.PP
Referenced by KLineEditDlg().
.SS "void KLineEditDlg::slotTextChanged (const \fBQString\fP &)\fC [protected, slot]\fP"
.PP
Enables and disables the OK button depending on the state returned by the lineedit's \fBQValidator\fP. 
.PP
Definition at line 139 of file klineeditdlg.cpp.
.PP
References QLineEdit::cursorPosition(), edit, KDialogBase::enableButton(), KDialogBase::enableButtonOK(), QString::isEmpty(), QString::length(), text(), QLineEdit::text(), and QLineEdit::validator().
.PP
Referenced by getText(), and KLineEditDlg().
.SH "Member Data Documentation"
.PP 
.SS "\fBKLineEdit\fP* \fBKLineEditDlg::edit\fP\fC [protected]\fP"
.PP
The line edit widget. 
.PP
Definition at line 117 of file klineeditdlg.h.
.PP
Referenced by KLineEditDlg(), slotClear(), slotTextChanged(), and text().

.SH "Author"
.PP 
Generated automatically by Doxygen for kdeui Library from the source code.
