qmultilineedit.3qt

qt-embedded-2.3.8.tar.gz源码

.TP
\fI Control-F \fR Move the cursor one character rightwards
.TP
\fI Control-H \fR Delete the character to the left of the cursor
.TP
\fI Control-K \fR Delete to end of line
.TP
\fI Control-N \fR Move the cursor one line downwards
.TP
\fI Control-P \fR Move the cursor one line upwards
.TP
\fI Control-V \fR Paste the clipboard text into line edit
.TP
\fI Control-X \fR Cut the marked text, copy to clipboard
.TP
\fI Control-Z \fR Undo the last operation
.TP
\fI Control-Y \fR Redo the last operation
.TP
\fI Control - Left Arrow \fR Move the cursor one word leftwards
.TP
\fI Control - Right Arrow \fR Move the cursor one word rightwards
.TP
\fI Control - Up Arrow \fR Move the cursor one word upwards
.TP
\fI Control - Down Arrow \fR Move the cursor one word downwards
.TP
\fI Control - Home Arrow \fR Move the cursor to the beginning of the text
.TP
\fI Control - End Arrow \fR Move the cursor to the end of the text In addition, the following key bindings are used on Windows:
.TP
\fI Shift - Delete \fR Cut the marked text, copy to clipboard
.TP
\fI Shift - Insert \fR Paste the clipboard text into line edit
.TP
\fI Control - Insert \fR Copy the marked text to the clipboard All other keys with valid ASCII codes insert themselves into the line.
.PP
Here are the default key bindings when isReadOnly() is TRUE:
.TP
\fI Left Arrow \fR Scrolls the table rightwards
.TP
\fI Right Arrow \fR Scrolls the table rightwards
.TP
\fI Up Arrow \fR Scrolls the table one line downwards
.TP
\fI Down Arrow \fR Scrolls the table one line upwards
.TP
\fI Page Up \fR Scrolls the table one page downwards
.TP
\fI Page Down \fR Scrolls the table one page upwards
.TP
\fI Control-C \fR Copy the marked text to the clipboard
.PP
Reimplemented from QWidget.
.SH "void QMultiLineEdit::killLine () \fC[virtual protected]\fR"
Deletes text from the current cursor position to the end of the line.
.SH "void QMultiLineEdit::leaveEvent ( QEvent * ) \fC[virtual protected]\fR"
Reimplemented for internal reasons; the API is not affected.
.PP
Reimplemented from QWidget.
.SH "int QMultiLineEdit::length () const"
Returns the length of the current text.
.PP
See also setMaxLength().
.SH "int QMultiLineEdit::lineLength ( int line ) const \fC[protected]\fR"
Returns the number of characters at line number \fIline.\fR
.SH "QString QMultiLineEdit::markedText () const \fC[protected]\fR"
Returns a copy of the marked text.
.SH "int QMultiLineEdit::maxLength () const"
Returns the currently set text length limit, or -1 if there is no limit (this is the default).
.PP
See also setMaxLength().
.SH "int QMultiLineEdit::maxLineLength () const"
Returns the currently set line length limit, or -1 if there is no limit (this is the default).
.PP
See also setMaxLineLength().
.SH "int QMultiLineEdit::maxLineWidth () const"
Returns the width in pixels of the longest text line in this editor.
.SH "int QMultiLineEdit::maxLines () const"
Returns the currently set line limit, or -1 if there is no limit (the default).
.PP
See also setMaxLines().
.SH "QSize QMultiLineEdit::minimumSizeHint () const \fC[virtual]\fR"
Returns a size sufficient for one character, and scroll bars.
.PP
Reimplemented from QWidget.
.SH "void QMultiLineEdit::mouseDoubleClickEvent ( QMouseEvent * m ) \fC[virtual protected]\fR"
Reimplemented for internal reasons; the API is not affected.
.PP
Reimplemented from QWidget.
.SH "void QMultiLineEdit::mouseMoveEvent ( QMouseEvent * e ) \fC[virtual protected]\fR"
Reimplemented for internal reasons; the API is not affected.
.PP
Reimplemented from QWidget.
.SH "void QMultiLineEdit::mousePressEvent ( QMouseEvent * e ) \fC[virtual protected]\fR"
Reimplemented for internal reasons; the API is not affected.
.PP
Reimplemented from QWidget.
.SH "void QMultiLineEdit::mouseReleaseEvent ( QMouseEvent * e ) \fC[virtual protected]\fR"
Reimplemented for internal reasons; the API is not affected.
.PP
Reimplemented from QWidget.
.SH "void QMultiLineEdit::newLine () \fC[virtual protected]\fR"
Makes a line break at the current cursor position.
.SH "int QMultiLineEdit::numLines () const"
Returns the number of lines in the editor. The count includes any empty lines at top and bottom, so for an empty editor this method will return 1.
.SH "void QMultiLineEdit::pageDown ( bool mark=FALSE ) \fC[virtual protected]\fR"
Moves the cursor one page down. If \fImark\fR is TRUE, the text is marked.
.SH "void QMultiLineEdit::pageUp ( bool mark=FALSE ) \fC[virtual protected]\fR"
Moves the cursor one page up. If \fImark\fR is TRUE, the text is marked.
.SH "void QMultiLineEdit::paintCell ( QPainter * painter, int row, int ) \fC[virtual protected]\fR"
Implements the basic drawing logic.
.PP
Reimplemented from QTableView.
.SH "void QMultiLineEdit::paste () \fC[slot]\fR"
Copies plain text from the clipboard onto the current cursor position. Any marked text is first deleted.
.SH "void QMultiLineEdit::pasteSubType ( const QCString & subtype ) \fC[slot]\fR"
Copies text in MIME subtype \fIsubtype\fR from the clipboard onto the current cursor position. Any marked text is first deleted.
.SH "void QMultiLineEdit::redo () \fC[slot]\fR"
Redoes the last text operation.
.SH "void QMultiLineEdit::redoAvailable ( bool yes ) \fC[signal]\fR"
This signal is emitted when the availability of redo changes. If \fIyes\fR is TRUE, then redo() will work until redoAvailable( FALSE ) is next emitted.
.SH "void QMultiLineEdit::removeLine ( int line ) \fC[virtual]\fR"
Deletes the line at line number \fIline.\fR If \fIline\fR is less than zero, or larger than the number of lines, no line is deleted.
.SH "void QMultiLineEdit::resizeEvent ( QResizeEvent * e ) \fC[virtual protected]\fR"
Reimplemented for internal reasons; the API is not affected.
.PP
Reimplemented from QWidget.
.SH "void QMultiLineEdit::returnPressed () \fC[signal]\fR"
This signal is emitted when the user presses the return or enter key. It is not emitted if isReadOnly() is TRUE.
.PP
See also textChanged().
.SH "void QMultiLineEdit::selectAll () \fC[slot]\fR"
Selects all text without moving the cursor.
.SH "void QMultiLineEdit::setAlignment ( int flags )"
Sets the alignment. Possible values are \fCAlignLeft, Align(H)Center\fR and \fCAlignRight.\fR
.PP
See also alignment() and Qt::AlignmentFlags.
.SH "void QMultiLineEdit::setAutoUpdate ( bool enable ) \fC[virtual]\fR"
Sets the auto-update option of multi-line editor to \fIenable.\fR
.PP
If \fIenable\fR is TRUE (this is the default) then the editor updates itself automatically whenever it has changed in some way (generally, when text has been inserted or deleted).
.PP
If \fIenable\fR is FALSE, the view does NOT repaint itself, or update its internal state variables itself when it is changed. This can be useful to avoid flicker during large changes, and is singularly useless otherwise: Disable auto-update, do the changes, re-enable auto-update, and call repaint().
.PP
\fBWarning:\fR Do not leave the view in this state for a long time (i.e. between events ). If, for example, the user interacts with the view when auto-update is off, strange things can happen.
.PP
Setting auto-update to TRUE does not repaint the view, you must call repaint() to do this (preferable repaint(FALSE) to avoid flicker).
.PP
See also autoUpdate() and repaint().
.SH "void QMultiLineEdit::setCursorPosition ( int line, int col, bool mark = FALSE ) \fC[virtual]\fR"
Sets the cursor position to character number \fIcol\fR in line number \fIline.\fR The parameters are adjusted to lie within the legal range.
.PP
If \fImark\fR is FALSE, the selection is cleared. otherwise it is extended
.PP
See also cursorPosition().
.SH "void QMultiLineEdit::setDefaultTabStop ( int ex ) \fC[static]\fR"
Sets the distance between tab stops for all QMultiLineEdit instances to \fIex,\fR which is measured in multiples of the width of a lower case 'x' in the widget's font. The initial value is 8.
.PP
\fBWarning:\fR This function does not cause a redraw. It is best to call it before any QMultiLineEdit widgets are shown.
.PP
See also defaultTabStop().
.SH "void QMultiLineEdit::setEchoMode ( EchoMode em )"
Sets the echo mode to \fIem.\fR The default is \fCNormal.\fR
.PP
The display is updated according.
.PP
See also setEchoMode().
.SH "void QMultiLineEdit::setEdited ( bool e )"
Sets the edited flag of this line edit to \fIe.\fR The edited flag is never read by QMultiLineEdit, but is changed to TRUE whenever the user changes its contents.
.PP
This is useful e.g. for things that need to provide a default value, but cannot find the default at once. Just open the widget without the best default and when the default is known, check the edited() return value and set the line edit's contents if the user has not started editing the line edit. Another example is to detect whether the contents need saving.
.PP
See also edited().
.SH "void QMultiLineEdit::setFixedVisibleLines ( int lines ) \fC[virtual]\fR"
Sets the fixed height of the QMultiLineEdit so that \fIlines\fR text lines are visible given the current font.
.PP
See also setMaxLines() and setFixedHeight().
.SH "void QMultiLineEdit::setFont ( const QFont & font ) \fC[virtual]\fR"
Reimplemented for internal reasons; the API is not affected.
.SH "void QMultiLineEdit::setHMargin ( int m ) \fC[virtual]\fR"
Sets the horizontal margin.
.PP
See also hMargin().
.SH "void QMultiLineEdit::setMaxLength ( int m )"
Sets the maximum text length to \fIm.\fR Use -1 for unlimited (the default). Existing overlong text will be truncated.
.PP
See also maxLength().
.SH "void QMultiLineEdit::setMaxLineLength ( int m ) \fC[virtual]\fR"
Sets the maximum length of lines to \fIm.\fR Use -1 for unlimited (the default). Existing long lines will be truncated.
.PP
See also maxLineLength().
.SH "void QMultiLineEdit::setMaxLines ( int m ) \fC[virtual]\fR"
Sets the maximum number of lines to \fIm.\fR Use -1 for unlimited (the default). Existing excess lines will be deleted.
.PP
Note that excess lines are deleted from the \fIbottom\fR of the lines. If you want teletype behaviour with lines disappearing from the \fItop\fR as the limit is exceed, you probably just want to use removeLine(0) prior to adding an excess line.
.PP
See also maxLines() and numLines().
.SH "void QMultiLineEdit::setOverwriteMode ( bool on ) \fC[virtual slot]\fR"
Sets overwrite mode if \fIon\fR is TRUE. Overwrite mode means that characters typed replace characters in the editor.
.PP
See also isOverwriteMode().
.SH "void QMultiLineEdit::setReadOnly ( bool on ) \fC[virtual slot]\fR"
If \fIon\fR is FALSE, this multi line edit accepts text input. Scrolling and cursor movements are accepted in any case.
.PP
See also isReadOnly() and QWidget::setEnabled().
.SH "void QMultiLineEdit::setSelection ( int row_from, int col_from, int row_to, int col_to ) \fC[virtual]\fR"
Marks the text starting at \fIrow_from, col_from\fR and ending at row_to, col_to.
.SH "void QMultiLineEdit::setText ( const QString & s ) \fC[virtual slot]\fR"
Sets the text to \fIs,\fR removing old text, if any.
.PP
Examples:
.(l
mainlyQt/editor.cpp mainlyMotif/editor.cpp scrollview/scrollview.cpp layout/layout.cpp mainlyXt/editor.cpp customlayout/main.cpp
.)l
.SH "void QMultiLineEdit::setUndoDepth ( int depth )"
Sets the maximum number of operations that can be stored on the undo stack.
.PP
See also undoDepth().
.SH "void QMultiLineEdit::setUndoEnabled ( bool enable )"
Sets undo enabled to \fIenable.\fR
.PP
See also isUndoEnabled().
.SH "void QMultiLineEdit::setValidator ( const QValidator * v ) \fC[virtual]\fR"
Not supported at this time.
.SH "void QMultiLineEdit::setWordWrap ( WordWrap mode )"
Sets the word wrap mode.
.PP
Per default, wrapping keeps words intact. To allow breaking within words, set the wrap policy to \fCAnywhere\fR (see setWrapPolicy() ).
.PP
The default wrap mode is \fCNoWrap.\fR
.PP
See also wordWrap(), setWrapColumnOrWidth() and setWrapPolicy().
.SH "void QMultiLineEdit::setWrapColumnOrWidth ( int value )"
Sets the wrap column or wrap width, depending on the word wrap mode.
.PP
See also setWordWrap().
.SH "void QMultiLineEdit::setWrapPolicy ( WrapPolicy policy )"
Defines where text can be wrapped in word wrap mode.
.PP
The default is \fCAtWhiteSpace.\fR
.PP
See also setWordWrap() and wrapPolicy().
.SH "QSize QMultiLineEdit::sizeHint () const \fC[virtual]\fR"
Reimplemented for internal reasons; the API is not affected.
.PP
Reimplemented from QWidget.
.SH "QSizePolicy QMultiLineEdit::sizePolicy () const \fC[virtual]\fR"
Reimplemented for internal reasons; the API is not affected.
.PP
Reimplemented from QWidget.
.SH "QString QMultiLineEdit::stringShown ( int row ) const \fC[protected]\fR"
Returns the string shown at line \fIrow,\fR including processing of the echoMode().
.SH "QString QMultiLineEdit::text () const"
Returns a copy of the whole text. If the multi line edit contains no text, a null string is returned.
.SH "void QMultiLineEdit::textChanged () \fC[signal]\fR"
This signal is emitted when the text is changed by an event or by a slot. Note that the signal is not emitted when you call a non-slot function such as insertLine().
.PP
See also returnPressed().
.SH "QString QMultiLineEdit::textLine ( int line ) const"
Returns the text at line number \fIline\fR (possibly the empty string), or a null string if \fIline\fR is invalid.
.SH "int QMultiLineEdit::textWidth ( const QString & s ) \fC[protected]\fR"
Returns the width in pixels of the string \fIs.\fR NOTE: only appropriate for whole lines.
.SH "int QMultiLineEdit::textWidth ( int line ) \fC[protected]\fR"
Returns the width in pixels of the text at line \fIline.\fR
.SH "void QMultiLineEdit::timerEvent ( QTimerEvent * ) \fC[virtual protected]\fR"
Reimplemented for internal reasons; the API is not affected. Present for binary compatibility only!.
.PP
Reimplemented from QObject.
.SH "void QMultiLineEdit::undo () \fC[slot]\fR"
Undoes the last text operation.
.SH "void QMultiLineEdit::undoAvailable ( bool yes ) \fC[signal]\fR"
This signal is emitted when the availability of undo changes. If \fIyes\fR is TRUE, then undo() will work until undoAvailable( FALSE ) is next emitted.
.SH "int QMultiLineEdit::undoDepth () const"
Returns the maximum number of operations that can be stored on the undo stack.
.PP
See also setUndoDepth().
.SH "const QValidator * QMultiLineEdit::validator () const"
Not supported at this time.
.SH "void QMultiLineEdit::wheelEvent ( QWheelEvent * e ) \fC[virtual protected]\fR"
Reimplemented for internal reasons; the API is not affected. Passes wheel events to the vertical scrollbar.
.PP
Reimplemented from QWidget.
.SH "QMultiLineEdit::WordWrap QMultiLineEdit::wordWrap() const"
Returns the current word wrap mode.
.PP
See also setWordWrap().
.SH "int QMultiLineEdit::wrapColumnOrWidth () const"
Returns the wrap column or wrap width, depending on the word wrap mode.
.PP
See also setWordWrap() and setWrapColumnOrWidth().
.SH "QMultiLineEdit::WrapPolicy QMultiLineEdit::wrapPolicy() const"
Returns the current word wrap policy.
.PP
See also  setWrapPolicy().
.SH "SEE ALSO"
.BR http://doc.trolltech.com/qmultilineedit.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2001 Trolltech AS, http://www.trolltech.com.  See the
license file included in the distribution for a complete license
statement.
.SH AUTHOR
Generated automatically from the source code.
.SH BUGS
If you find a bug in Qt, please report it as described in
.BR http://doc.trolltech.com/bughowto.html .
Good bug reports make our job much simpler. Thank you.
.P
In case of content or formattting problems with this manual page, please
report them to
.BR [e-mail] .
Please include the name of the manual page (qmultilineedit.3qt) and the Qt
version (2.3.8).