qlineedit.3qt

tmark1.11:用于生成QT/EMBEDDED应用工程的Markfile文件

.TH QLineEdit 3qt "6 July 1999" "Troll Tech AS" \" -*- nroff -*-
.\" Copyright 1992-1999 Troll Tech AS.  All rights reserved.  See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
QLineEdit \- Simple line editor for inputting text
.SH SYNOPSIS
.br
.PP
\fC#include <qlineedit.h>\fR
.PP
Inherits QWidget.
.PP
Inherited by QRenameEdit.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQLineEdit\fR ( QWidget * " "parent" ", const char * " "name" "=0 )"
.br
.ti -1c
.BI "\fBQLineEdit\fR ( const QString &, QWidget * " "parent" ", const char * " "name" "=0 )"
.br
.ti -1c
.BI "\fB~QLineEdit\fR ()"
.br
.ti -1c
.BI "QString \fBtext\fR () const"
.br
.ti -1c
.BI "QString \fBdisplayText\fR () const"
.br
.ti -1c
.BI "int \fBmaxLength\fR () const"
.br
.ti -1c
.BI "virtual void \fBsetMaxLength\fR ( int )"
.br
.ti -1c
.BI "virtual void \fBsetFrame\fR ( bool )"
.br
.ti -1c
.BI "bool \fBframe\fR () const"
.br
.ti -1c
.BI "enum \fBEchoMode\fR { Normal, NoEcho, Password }"
.br
.ti -1c
.BI "virtual void \fBsetEchoMode\fR ( EchoMode )"
.br
.ti -1c
.BI "EchoMode \fBechoMode\fR () const"
.br
.ti -1c
.BI "virtual void \fBsetValidator\fR ( const QValidator * )"
.br
.ti -1c
.BI "const QValidator* \fBvalidator\fR () const"
.br
.ti -1c
.BI "virtual QSize \fBsizeHint\fR () const"
.br
.ti -1c
.BI "virtual QSize \fBminimumSizeHint\fR () const"
.br
.ti -1c
.BI "virtual QSizePolicy \fBsizePolicy\fR () const"
.br
.ti -1c
.BI "virtual void \fBsetEnabled\fR ( bool )"
.br
.ti -1c
.BI "virtual void \fBsetFont\fR ( const QFont & )"
.br
.ti -1c
.BI "virtual void \fBsetPalette\fR ( const QPalette & )"
.br
.ti -1c
.BI "virtual void \fBsetSelection\fR ( int, int )"
.br
.ti -1c
.BI "virtual void \fBsetCursorPosition\fR ( int )"
.br
.ti -1c
.BI "int \fBcursorPosition\fR () const"
.br
.ti -1c
.BI "bool \fBvalidateAndSet\fR ( const QString &, int, int, int )"
.br
.ti -1c
.BI "void \fBcut\fR ()"
.br
.ti -1c
.BI "void \fBcopy\fR () const"
.br
.ti -1c
.BI "void \fBpaste\fR ()"
.br
.ti -1c
.BI "void \fBsetAlignment\fR ( int flag )"
.br
.ti -1c
.BI "int \fBalignment\fR () const"
.br
.ti -1c
.BI "void \fBcursorLeft\fR ( bool " "mark" ", int " "steps" " = 1 )"
.br
.ti -1c
.BI "void \fBcursorRight\fR ( bool " "mark" ", int " "steps" " = 1 )"
.br
.ti -1c
.BI "void \fBcursorWordForward\fR ( bool mark )"
.br
.ti -1c
.BI "void \fBcursorWordBackward\fR ( bool mark )"
.br
.ti -1c
.BI "void \fBbackspace\fR ()"
.br
.ti -1c
.BI "void \fBdel\fR ()"
.br
.ti -1c
.BI "void \fBhome\fR ( bool mark )"
.br
.ti -1c
.BI "void \fBend\fR ( bool mark )"
.br
.ti -1c
.BI "void \fBsetEdited\fR ( bool )"
.br
.ti -1c
.BI "bool \fBedited\fR () const"
.br
.ti -1c
.BI "bool \fBhasMarkedText\fR () const"
.br
.ti -1c
.BI "QString \fBmarkedText\fR () const"
.br
.in -1c
.SS "Public Slots"
.in +1c
.ti -1c
.BI "virtual void \fBsetText\fR ( const QString & )"
.br
.ti -1c
.BI "void \fBselectAll\fR ()"
.br
.ti -1c
.BI "void \fBdeselect\fR ()"
.br
.ti -1c
.BI "void \fBclearValidator\fR ()"
.br
.ti -1c
.BI "void \fBinsert\fR ( const QString & )"
.br
.ti -1c
.BI "void \fBclear\fR ()"
.br
.in -1c
.SS "Signals"
.in +1c
.ti -1c
.BI "void \fBtextChanged\fR ( const QString & )"
.br
.ti -1c
.BI "void \fBreturnPressed\fR ()"
.br
.in -1c
.SS "Protected Members"
.in +1c
.ti -1c
.BI "virtual void \fBmousePressEvent\fR ( QMouseEvent * )"
.br
.ti -1c
.BI "virtual void \fBmouseMoveEvent\fR ( QMouseEvent * )"
.br
.ti -1c
.BI "virtual void \fBmouseReleaseEvent\fR ( QMouseEvent * )"
.br
.ti -1c
.BI "virtual void \fBmouseDoubleClickEvent\fR ( QMouseEvent * )"
.br
.ti -1c
.BI "virtual void \fBkeyPressEvent\fR ( QKeyEvent * )"
.br
.ti -1c
.BI "virtual void \fBfocusInEvent\fR ( QFocusEvent * )"
.br
.ti -1c
.BI "virtual void \fBfocusOutEvent\fR ( QFocusEvent * )"
.br
.ti -1c
.BI "virtual void \fBpaintEvent\fR ( QPaintEvent * )"
.br
.ti -1c
.BI "virtual void \fBresizeEvent\fR ( QResizeEvent * )"
.br
.ti -1c
.BI "virtual void \fBleaveEvent\fR ( QEvent * )"
.br
.ti -1c
.BI "virtual void \fBdragEnterEvent\fR ( QDragEnterEvent * )"
.br
.ti -1c
.BI "virtual void \fBdropEvent\fR ( QDropEvent * )"
.br
.ti -1c
.BI "void \fBrepaintArea\fR ( int, int )"
.br
.in -1c
.SH DESCRIPTION
The QLineEdit widget is a simple line editor for inputting text.
.PP
The default QLineEdit object has its own frame as specified by the Windows/Motif style guides, you can turn off the frame by calling setFrame( FALSE ).
.PP
It draws the text using its own color group: colorGroup().text() on colorGroup().base(). The cursor and frame use other colors from same color group, of course.
.PP
QLineEdit can display the content of itself in three ways, depending on the current echo mode. The echo modes available are: 
.TP
\fCNormal\fR - display characters as they are entered. This is the default. 
.TP
\fCNoEcho\fR - do not display anything. 
.TP
\fCPassword\fR - display asterisks instead of the characters actually entered. 
.PP
The default key bindings are described in keyPressEvent(); they cannot be customized except by inheriting the class.
.PP
<img src=qlined-m.png> <img src=qlined-w.png>
.PP
See also: QMultiLineEdit, QLabel, QComboBox, GUI Design Handbook: Field, Entry, and GUI Design Handbook: Field, Required.
.PP
Examples:
.(l
tabdialog/tabdialog.cpp xform/xform.cpp layout/layout.cpp popup/popup.cpp
.)l
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QLineEdit::QLineEdit ( QWidget * parent, const char * name=0 )"
Constructs a line editor with an empty edit buffer.
.PP
The cursor position is set to the start of the line, the maximum buffer size to 32767 characters, and the buffer contents to "".
.PP
The \fIparent\fR and \fIname\fR arguments are sent to the QWidget constructor.
.SH "QLineEdit::QLineEdit ( const QString & contents, QWidget * parent, const char * name=0 )"
Constructs a line editor whose edit buffer starts out as \fIcontents.\fR
.PP
The cursor position is set to the end of the line and the maximum buffer size to 32767 characters.
.PP
The \fIparent\fR and \fIname\fR arguments are sent to the QWidget constructor.
.SH "QLineEdit::~QLineEdit ()"
Destroys the line editor.
.SH "int QLineEdit::alignment () const"
Returns the current alignment of the line editor. Possible Values are Qt::AlignLeft, Qt::AlignRight and Qt::AlignCenter.
.PP
See also: setAlignment().
.SH "void QLineEdit::backspace ()"
Deletes the character on the left side of the text cursor and moves the cursor one position to the left. If a text has been marked by the user (e.g. by clicking and dragging) the cursor will be put at the beginning of the marked text and the marked text will be removed.
.PP
See also: del().
.SH "void QLineEdit::clear () \fC[slot]\fR"
Syntax sugar for setText( "" ), provided to match no-argument signals.