强大的QTextEdit功能

QTextEdit窗口部件提供了强大的单页面的多信息文本编辑器。 详情请见…… #include 继承了QScrollView。

被QMultiLineEdit、QTextBrowser和QTextView继承。 所有成员函数的列表。

公有成员

? ? ? ?

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?

enum WordWrap { NoWrap, WidgetWidth, FixedPixelWidth, FixedColumnWidth }

enum WrapPolicy { AtWordBoundary, Anywhere, AtWhiteSpace = AtWordBoundary }

enum KeyboardAction { ActionBackspace, ActionDelete, ActionReturn, ActionKill }

enum CursorAction { MoveBackward, MoveForward, MoveWordBackward, MoveWordForward, MoveUp, MoveDown, MoveLineStart, MoveLineEnd, MoveHome, MoveEnd, MovePgUp, MovePgDown }

enum VerticalAlignment { AlignNormal, AlignSuperScript, AlignSubScript }

QTextEdit ( const QString & text, const QString & context = QString::null, QWidget * parent = 0, const char * name = 0 )

QTextEdit ( QWidget * parent = 0, const char * name = 0 ) QString text () const

QString text ( int para ) const TextFormat textFormat () const QString context () const

QString documentTitle () const

void getSelection ( int * paraFrom, int * indexFrom, int * paraTo, int * indexTo, int selNum = 0 ) const

virtual bool find ( const QString & expr, bool cs, bool wo, bool forward = TRUE, int * para = 0, int * index = 0 ) int paragraphs () const int lines () const

int linesOfParagraph ( int para ) const int lineOfChar ( int para, int index ) int length () const

QRect paragraphRect ( int para ) const

int paragraphAt ( const QPoint & pos ) const int charAt ( const QPoint & pos, int * para ) const int paragraphLength ( int para ) const

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?

QStyleSheet * styleSheet () const

QMimeSourceFactory * mimeSourceFactory () const QBrush paper () const

bool linkUnderline () const

virtual int heightForWidth ( int w ) const bool hasSelectedText () const QString selectedText () const bool isUndoAvailable () const bool isRedoAvailable () const WordWrap wordWrap () const int wrapColumnOrWidth () const WrapPolicy wrapPolicy () const int tabStopWidth () const

QString anchorAt ( const QPoint & pos ) bool isReadOnly () const

void getCursorPosition ( int * para, int * index ) const bool isModified () const bool italic () const bool bold () const

bool underline () const QString family () const int pointSize () const QColor color () const QFont font () const int alignment () const int undoDepth () const

bool isOverwriteMode () const

QColor paragraphBackgroundColor ( int para ) const bool isUndoRedoEnabled () const

公有槽

? ? ? ? ? ? ? ? ? ? ? ?

virtual void setMimeSourceFactory ( QMimeSourceFactory * factory ) virtual void setStyleSheet ( QStyleSheet * styleSheet ) virtual void scrollToAnchor ( const QString & name ) virtual void setPaper ( const QBrush & pap ) virtual void setLinkUnderline ( bool )

virtual void setWordWrap ( WordWrap mode ) virtual void setWrapColumnOrWidth ( int ) virtual void setWrapPolicy ( WrapPolicy policy ) virtual void copy ()

virtual void append ( const QString & text ) void setText ( const QString & txt )

virtual void setText ( const QString & text, const QString & context )

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?

virtual void setTextFormat ( TextFormat f ) virtual void selectAll ( bool select = TRUE ) virtual void setTabStopWidth ( int ts ) virtual void zoomIn ( int range ) virtual void zoomIn ()

virtual void zoomOut ( int range ) virtual void zoomOut ()

virtual void zoomTo ( int size ) virtual void setReadOnly ( bool b ) virtual void undo () virtual void redo () virtual void cut () virtual void paste ()

virtual void pasteSubType ( const QCString & subtype ) virtual void clear () virtual void del () virtual void indent ()

virtual void setItalic ( bool b ) virtual void setBold ( bool b )

virtual void setUnderline ( bool b )

virtual void setFamily ( const QString & fontFamily ) virtual void setPointSize ( int s )

virtual void setColor ( const QColor & c )

virtual void setVerticalAlignment ( VerticalAlignment a ) virtual void setAlignment ( int a )

virtual void setCursorPosition ( int para, int index )

virtual void setSelection ( int paraFrom, int indexFrom, int paraTo, int indexTo, int selNum = 0 )

virtual void setSelectionAttributes ( int selNum, const QColor & back, bool invertText )

virtual void setModified ( bool m ) virtual void setUndoDepth ( int d ) virtual void ensureCursorVisible ()

virtual void placeCursor ( const QPoint & pos, QTextCursor * c = 0 ) virtual void moveCursor ( CursorAction action, bool select ) virtual void doKeyboardAction ( KeyboardAction action ) virtual void removeSelectedText ( int selNum = 0 ) virtual void removeSelection ( int selNum = 0 ) virtual void setCurrentFont ( const QFont & f ) virtual void setOverwriteMode ( bool b ) virtual void scrollToBottom ()

virtual void insert ( const QString & text, bool indent = FALSE, bool checkNewLine = TRUE, bool removeSelected = TRUE ) virtual void insertAt ( const QString & text, int para, int index )

? ? ? ? ?

virtual void removeParagraph ( int para )

virtual void insertParagraph ( const QString & text, int para )

virtual void setParagraphBackgroundColor ( int para, const QColor & bg ) virtual void clearParagraphBackground ( int para ) virtual void setUndoRedoEnabled ( bool b )

信号

? ? ? ? ? ? ? ? ? ? ? ? ?

void textChanged ()

void selectionChanged ()

void copyAvailable ( bool yes ) void undoAvailable ( bool yes ) void redoAvailable ( bool yes )

void currentFontChanged ( const QFont & f ) void currentColorChanged ( const QColor & c ) void currentAlignmentChanged ( int a )

void currentVerticalAlignmentChanged ( VerticalAlignment a ) void cursorPositionChanged ( QTextCursor * c ) void cursorPositionChanged ( int para, int pos ) void returnPressed ()

void modificationChanged ( bool m )

属性

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?

QString documentTitle - 从文本中分析出的文档标题 （只读） bool hasSelectedText - 是否有文本被选择到选择区0中 （只读） int length - 文本的字符数 （只读）

bool linkUnderline - 超文本链接是否使用下划线 bool modified - 文档是否已经被用户修改 bool overwriteMode - 文本编辑的覆盖模式 QBrush paper - 背景（纸）的画刷 bool readOnly - 文本编辑是否只读

QString selectedText - 被选择的文本（在选择区0中）或者如果当前没有被选择的文本（在选择区0中）就是空字符串 （只读） int tabStopWidth - tab stop的象素宽度s QString text - 文本编辑的文本

TextFormat textFormat - 文本格式：多信息文本、一般文本或者自动文本 int undoDepth - 撤销历史的深度

bool undoRedoEnabled - 撤销/恢复是否生效 WordWrap wordWrap - 自动换行模式

int wrapColumnOrWidth - 被自动换行的文本的位置（根据自动换行模式来决定是像素还是列）

WrapPolicy wrapPolicy - 自动换行策略，在空白符号还是在任何地方

保护成员

? ? ? ? ? ?

void repaintChanged ()

virtual void keyPressEvent ( QKeyEvent * e ) virtual bool focusNextPrevChild ( bool n ) QTextCursor * textCursor () const

virtual QPopupMenu * createPopupMenu ( const QPoint & pos ) virtual QPopupMenu * createPopupMenu () (obsolete)

详细描述

QTextEdit窗口部件提供了强大的单页面的多信息文本编辑器。 介绍和概念

? 使用QTextEdit作为一个显示窗口部件

o 只读的键绑定

? 使用QTextEdit作为一个编辑器

o 编辑键绑定

?

介绍和概念

QTextEdit是一个高级的所见即所得的支持使用HTML风格标记的多信息文本格式的查看器/编辑器。它对于处理大文档和快速相应用户的输入进行了优化。 QTextEdit操作的三个模式： 模式

命令

注释

一般setTextFormat(PlainText) 使用setText()设置文本，text()可以返回一般文文本本。文本属性（比如颜色）可以被设置，但是一编辑般文本总是被返回。1. 器

多信setTextFormat(RichText) 使用setText()设置文本，text()可以返回多信息文息文本。多信息文本编辑是相当受限制的。例如你不本编能设置边白或者插入图片（尽管你可以读取并且辑器 正确地显示具有边白和包含图片的文件）。这个

模式对于编辑少量的多信息文本是非常有用的。2. 文本setReadOnly(TRUE)

使用setText()或append()（这个没有撤销历史，

Shift+Wheel Ctrl+Wheel

水平的滚动文本（Wheel就是鼠标滚轮） 缩放文本

要选择（标定）文本，按下一个移动键的同时按住Shift键，例如Shift+右箭头将会选择右面的字符，并且Shift+Ctrl+右箭头将会选择右面的单字，等等。 默认情况下，文本编辑窗口部件在插入模式下工作，所以用户输入的文本都被插入到文本编辑中并且光标右面的文本都会移动到不碍事的地方。使用

setOverwriteMode()，这个模式可以被改为覆盖，这时新文本将覆盖光标右面存在的任何文本。

也可以参考基本窗口部件和文本相关类。

成员类型文档

QTextEdit::CursorAction

这个枚举变量被moveCursor()使用，它用来指定光标应该被移动的方向：

? ? ? ? ? ? ? ? ? ? ? ?

QTextEdit::MoveBackward - 向后移动光标一个字符 QTextEdit::MoveWordBackward - 向后移动光标一个单字 QTextEdit::MoveForward - 向前移动光标一个字符 QTextEdit::MoveWordForward - 向前移动光标一个单字 QTextEdit::MoveUp - 向上移动光标一行 QTextEdit::MoveDown - 向下移动光标一行 QTextEdit::MoveLineStart - 移动光标到行首 QTextEdit::MoveLineEnd - 移动光标到行尾 QTextEdit::MoveHome - 移动光标到文首 QTextEdit::MoveEnd - 移动光标到文尾 QTextEdit::MovePgUp - 向上移动光标一页 QTextEdit::MovePgDown - 向下移动光标一页

QTextEdit::KeyboardAction

这个枚举变量被doKeyboardAction()使用，它用来指定哪个操作被执行： QTextEdit::ActionBackspace - 删除光标左面的字符。 ? QTextEdit::ActionDelete - 删除光标右面的字符。 ? QTextEdit::ActionReturn - 在光标位置分割段落。

?

?

QTextEdit::ActionKill - 如果光标不在段尾，从光标位置删除字符，直到段尾。如果光标在段尾，删除段尾的硬回车符——这将会导致这个段落和随后的段落被连接在一起。

QTextEdit::VerticalAlignment

这个枚举变量被用来设置文本的垂直对齐方式。 QTextEdit::AlignNormal - 普通对齐 ? QTextEdit::AlignSuperScript - 上标 ? QTextEdit::AlignSubScript - 下标

?

QTextEdit::WordWrap

这个枚举变量定义了QTextEdit的自动换行模式。下面这些值是有效的： QTextEdit::NoWrap - 不自动换行。

? QTextEdit::WidgetWidth - 在窗口部件的当前宽度自动换行（这是默认的）。默认在空白符号处自动换行，这可以使用setWrapPolicy()来改变。 ? QTextEdit::FixedPixelWidth - 从窗口部件的左侧开始的固定数量的象素数自动换行。象素的数量可以通过wrapColumnOrWidth()来设置。 ? QTextEdit::FixedColumnWidth - 从窗口部件左侧开始的固定数量的列数自动换行。列数可以通过wrapColumnOrWidth()设置。如果你需要使用等宽文本在设备上显示很好的格式文本，这是很有用的，例如标准的VT100终端，你可以把wrapColumnOrWidth()设置为80。

?

也可以参考wordWrap和wordWrap。

QTextEdit::WrapPolicy

这个枚举变量定义了自动换行模式在哪里自动换行。 下面这些值是有效的：

QTextEdit::AtWhiteSpace - 在空白符号处（空格或者换行）自动换行。 ? QTextEdit::Anywhere - 在任何情况下自动换行，包括单字中。 ? QTextEdit::AtWordBoundary - 不要使用这个不赞成的值（它是AtWhiteSpace的同义字，请使用后者替换它）。

?

也可以参考wrapPolicy。

成员函数文档

QTextEdit::QTextEdit ( const QString & text, const QString & context

= QString::null, QWidget * parent = 0, const char * name = 0 )

使用父对象parent和名称name构造一个QTextEdit。文本编辑将使用上下文context来显示文本text。

context是文本编辑的QMimeSourceFactory用来解析文件和图片的定位的路径。当查询数据时，它被传递给mimeSourceFactory()。

例如，如果文本包含一个文本标签href=\，将会被识别为“path/to/look/in/target.html”。

QTextEdit::QTextEdit ( QWidget * parent = 0, const char * name = 0 )

使用父对象parent和名称name构造一个空的QTextEdit。

int QTextEdit::alignment () const

返回当前段落的对齐方式。 也可以参考setAlignment()。

QString QTextEdit::anchorAt ( const QPoint & pos )

如果在pos位置有一个锚（在内容坐标中），它的名称被返回，否则返回空字符串。

void QTextEdit::append ( const QString & text ) [虚 槽]

把文本text添加到文本编辑的结尾。注意这个函数会清空撤销/恢复历史。 实例：network/clientserver/client/client.cpp、network/clientserver/server/server.cpp、network/httpd/httpd.cpp和process/process.cpp。

bool QTextEdit::bold () const

如果当前格式是粗体的，返回真，否则返回假。 也可以参考setBold()。

int QTextEdit::charAt ( const QPoint & pos, int * para ) const

返回在pos位置（在内容坐标中）的字符的索引（相对于它的段落）。如果para不为零，*para被设置为当前段落。如果在pos没有字符，-1被返回。

void QTextEdit::clear () [虚 槽]

删除文本编辑中的所有文本。

也可以参考cut(), removeSelectedText()和text。

void QTextEdit::clearParagraphBackground ( int para ) [虚 槽]

清除para段落的背景色，所以背景色将再次被使用。

QColor QTextEdit::color () const

返回当前格式的颜色。 也可以参考setColor()和paper。

QString QTextEdit::context () const

返回编辑的context。context是文本编辑的QMimeSourceFactory用来解析文件和图片的定位的路径。 也可以参考text。

实例：helpviewer/helpwindow.cpp和qdir/qdir.cpp。

void QTextEdit::copy () [虚 槽]

复制任何选择文本（从选择区0中）到剪贴板。 也可以参考hasSelectedText和copyAvailable()。

void QTextEdit::copyAvailable ( bool yes ) [信号]

当文本编辑中的文本被选择或者取消选择时，这个信号被发射。

当文本被选择时，这个信号被发射，这时yes被设置为真。如果没有文本被选择或者如果被选择文本被取消选择，这个信号被发射，这时yes被设置为假。

如果yes为真，那么copy()可以被用来复制所选文本到剪贴板。如果yes为假，那么copy()什么也不做。 也可以参考selectionChanged()。

QPopupMenu * QTextEdit::createPopupMenu ( const QPoint & pos )

[虚 保护]

这个函数被用来在文档pos位置创建一个右键弹出菜单。如果你想创建一个自定义弹出菜单，重新实现这个函数并且返回被创建的弹出菜单。弹出菜单的所有权被传递给调用者。

QPopupMenu * QTextEdit::createPopupMenu () [虚 保护]

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。 这个函数是废弃的。它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。

这个函数被用来创建一个右键弹出菜单。如果你想创建一个自定义弹出菜单，重新实现这个函数并且返回被创建的弹出菜单。弹出菜单的所有权被传递给调用者。 这个函数只有在createPopupMenu( const QPoint & )返回0时才能被调用。

void QTextEdit::currentAlignmentChanged ( int a ) [信号]

如果当前段落的对齐方式已经改变时，这个信号被发射。 新的对齐方式是a。 也可以参考setAlignment()。

void QTextEdit::currentColorChanged ( const QColor & c ) [信号]

如果当前格式的颜色已经改变时，这个信号被发射。 新的颜色是c。 也可以参考setColor()。

void QTextEdit::currentFontChanged ( const QFont & f ) [信号]

int QTextEdit::linesOfParagraph ( int para ) const

返回para段落的行数，或者如果在para索引没有这个段落，返回-1。

bool QTextEdit::linkUnderline () const

如果超文本链接将显示下划线，返回真，否则返回假。详细情况请参考“linkUnderline”属性。

QMimeSourceFactory * QTextEdit::mimeSourceFactory () const

返回这个文档编辑当前使用的QMimeSourceFactory。 也可以参考setMimeSourceFactory()。

实例：helpviewer/helpwindow.cpp和qdir/qdir.cpp。

void QTextEdit::modificationChanged ( bool m ) [信号]

当文档修改发生改变时，这个信号被发射。如果m为真，文档被修改了，否则修改状态已经被重置为未修改。 也可以参考modified。

void QTextEdit::moveCursor ( CursorAction action, bool select ) [虚

槽]

根据action移动文本光标。这通常被一些键盘事件处理器使用。select指定从当前光标位置到新位置之间的文本是否应该被选定。

QBrush QTextEdit::paper () const

返回背景（纸）的画刷。详细情况请参考“paper”属性。

int QTextEdit::paragraphAt ( const QPoint & pos ) const

返回在pos位置（在内容坐标中）的段落，或者如果在pos索引没有段落，返回-1。

QColor QTextEdit::paragraphBackgroundColor ( int para ) const

返回para段落的背景色或者如果para超出范围或者这个段落没有背景设置，返回一个无效的颜色。

int QTextEdit::paragraphLength ( int para ) const

返回para段落的长度（字符数），或者如果para超出范围或者这个段落没有背景设置，返回-1。

QRect QTextEdit::paragraphRect ( int para ) const

返回para段落在内容坐标中的矩形，或者如果para超出范围，返回一个无效矩形。

int QTextEdit::paragraphs () const

返回文本中的段落数，它可以为0。

void QTextEdit::paste () [虚 槽]

把剪贴板中的文本粘贴到文本编辑的当前光标位置。只有一般文本能够被粘贴。 如果剪贴板中没有文本，就什么也没发生。

也可以参考pasteSubType(), cut()和QTextEdit::copy()。

void QTextEdit::pasteSubType ( const QCString & subtype ) [虚 槽]

把剪贴板中格式为subtype的文本粘贴到文本编辑的当前光标位置。subtype可以是“plain”或“html”。

如果剪贴板中没有subtype格式的文本，就什么也没发生。 也可以参考paste(), cut()和QTextEdit::copy()。

void QTextEdit::placeCursor ( const QPoint & pos, QTextCursor * c =

0 ) [虚 槽]

在离pos位置（在内容坐标中）最近的字符放置光标c。如果c为0，默认的文本光标被放置。

也可以参考setCursorPosition()。

int QTextEdit::pointSize () const

返回当前格式的字体的点的大小。

也可以参考setFamily(), setCurrentFont()和setPointSize()。

void QTextEdit::redo () [虚 槽]

恢复上一次操作。

如果没有操作可以恢复，例如，在撤销/恢复历史中没有恢复步骤，就什么也没发生。

也可以参考redoAvailable(), undo()和undoDepth。

void QTextEdit::redoAvailable ( bool yes ) [信号]

当恢复的可用性发生改变时，这个信号被发射。如果yes为真，那么redo()可以一直工作到redoAvailable( FALSE )被发射。 也可以参考redo()和undoDepth。

void QTextEdit::removeParagraph ( int para ) [虚 槽]

移除para段落。

void QTextEdit::removeSelectedText ( int selNum = 0 ) [虚 槽]

删除selNum（默认为0）选择区中的被选定文本（也就是默认选择的文本）。如果没有被选定文本，就什么也没发生。 也可以参考selectedText和removeSelection()。

void QTextEdit::removeSelection ( int selNum = 0 ) [虚 槽]

移除selNum（默认为0）选择区。这不会移除被选定文本。 也可以参考removeSelectedText()。

void QTextEdit::repaintChanged () [保护]

重新绘制任何已经改变的段落。

尽管在内部广泛地使用，但是你也不应该需要自己调用这个函数。

void QTextEdit::returnPressed () [信号]

如果用户按下回车键或者换行键，这个信号被发射。

void QTextEdit::scrollToAnchor ( const QString & name ) [虚 槽]

滚动文本编辑来使在被叫作name的锚的文本可视，如果它在文档中可以被发现的话。如果这个锚不能被找到，就没有滚动发生。锚是使用HTML锚标签，也就是

void QTextEdit::scrollToBottom () [虚 槽]

滚动到文本的底部并且如果需要就重新执行格式操作。

void QTextEdit::selectAll ( bool select = TRUE ) [虚 槽]

如果select为真（默认），所有的文本都被选择作为选择区0。如果select为假，所有的文本都被取消选择，也就是默认选择区（选择区0）被清空。 也可以参考selectedText。

QString QTextEdit::selectedText () const

返回被选定文本（从选择区0中）或者如果当前没有被选定文本（在选择区0中）返回空字符串。详细情况请参考“selectedText”属性。

void QTextEdit::selectionChanged () [信号]

只要选择发生改变，这个信号就被发射。 也可以参考setSelection()和copyAvailable()。

void QTextEdit::setAlignment ( int a ) [虚 槽]

设置当前段落的对齐方式为a。有效的对齐方式为Qt::AlignLeft、Qt::AlignRight、Qt::AlignJustify和Qt::AlignCenter（这个是水平中间）。 在QMultiLineEdit中被重新实现。

void QTextEdit::setBold ( bool b ) [虚 槽]

如果b为真，设置当前格式为粗体，否则设置当前格式为非粗体。 也可以参考bold()。

void QTextEdit::setColor ( const QColor & c ) [虚 槽]

设置当前格式的颜色，也就是文本的颜色，为c。 也可以参考color()和paper。 实例：action/actiongroup/editor.cpp。

void QTextEdit::setCurrentFont ( const QFont & f ) [虚 槽]

设置当前格式的字体为f。

也可以参考font(), setPointSize()和setFamily()。

void QTextEdit::setCursorPosition ( int para, int index ) [虚 槽]

设置光标到para段落的index位置。 也可以参考getCursorPosition()。

void QTextEdit::setFamily ( const QString & fontFamily ) [虚 槽]

设置当前格式的字体族为fontFamily。 也可以参考family()和setCurrentFont()。

void QTextEdit::setItalic ( bool b ) [虚 槽]

如果b为真，设置当前格式为斜体，否则设置当前格式为非斜体。 也可以参考italic()。

void QTextEdit::setLinkUnderline ( bool ) [虚 槽]

设置超文本链接是否显示下划线。详细情况请参考“linkUnderline”属性。

void QTextEdit::setMimeSourceFactory

( QMimeSourceFactory * factory ) [虚 槽]

设置文本编辑的mime源工厂为 factory。详细情况请参考QMimeSourceFactory。 也可以参考mimeSourceFactory()。

void QTextEdit::setModified ( bool m ) [虚 槽]

设置文档是否已经被用户修改为m。详细情况请参考“modified”属性。

void QTextEdit::setOverwriteMode ( bool b ) [虚 槽]

设置文本编辑的覆盖模式为b。详细情况请参考“overwriteMode”属性。

void QTextEdit::setPaper ( const QBrush & pap ) [虚 槽]

设置背景（纸）的画刷为pap。详细情况请参考“paper”属性。

void QTextEdit::setParagraphBackgroundColor ( int para,

const QColor & bg ) [虚 槽]

设置para段落的背景色为bg。

void QTextEdit::setPointSize ( int s ) [虚 槽]

设置当前格式的点大小为s。

注意如果s为0或者负数，这个函数的行为是不确定的。 也可以参考pointSize(), setCurrentFont()和setFamily()。

void QTextEdit::setReadOnly ( bool b ) [虚 槽]

设置文本编辑是否只读为b。详细情况请参考“readOnly”属性。

void QTextEdit::setSelection ( int paraFrom, int indexFrom, int paraTo,

int indexTo, int selNum = 0 ) [虚 槽]

设置一个选择从paraFrom段落的indexFrom位置开始，直到paraTo段落的indexTo位置结束。有不同id（selNum）的选择区不会被移除，有相同id（selNum）的选择区会被移除。

使用selNum选择区的选择设置。如果selNum为0，这个就是默任选择了。 如果selNum为0，光标被移动到这个选择的结尾，否则光标位置保持不变。 也可以参考getSelection()和selectedText。

void QTextEdit::setSelectionAttributes ( int selNum,

const QColor & back, bool invertText ) [虚 槽]

设置selNum选择区的背景色为back并且指定这个选择区的文本是否应该被使用invertText反白。

这个只在selNum > 0的时候工作。默认选择（selNum == 0）从这个窗口部件的colorGroup()得到它的属性。

void QTextEdit::setStyleSheet ( QStyleSheet * styleSheet ) [虚 槽]

设置这个文本编辑使用的样式单为styleSheet。改变仅对通过setText()或append()新增的文本有效。 也可以参考styleSheet()。

void QTextEdit::setTabStopWidth ( int ts ) [虚 槽]

设置tab stop宽度为ts象素。详细情况请参考“tabStopWidth”属性。

void QTextEdit::setText ( const QString & txt ) [槽]

设置文本编辑的文本为txt。详细情况请参考“text”属性。

void QTextEdit::setText ( const QString & text,

const QString & context ) [虚 槽]

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。 改变文本编辑的文本为txt并且上下文为context。任何以前的文本都被移除。 text可以被解释为一般文本或者多信息文本，取决于textFormat()。默认设置为AutoText，也就是说文本编辑从text中自动检测格式。

选项context就是文本编辑的QMimeSourceFactory用来解析文件和图片的定位的路径。（请参考QTextEdit::QTextEdit()。）当查询数据时，它被传递给mimeSourceFactory()。

注意这个函数会清空撤销/恢复历史。 也可以参考text和textFormat。

void QTextEdit::setTextFormat ( TextFormat f ) [虚 槽]

设置文本格式：多信息文本、一般文本或者自动文本为f。详细情况请参考“textFormat”属性。

void QTextEdit::setUnderline ( bool b ) [虚 槽]

如果b为真，设置当前格式是有下划线的，否则设置当前格式是没有下划线的。 也可以参考underline()。

void QTextEdit::setUndoDepth ( int d ) [虚 槽]

设置撤销历史的深度为d。详细情况请参考“undoDepth”属性。

void QTextEdit::setUndoRedoEnabled ( bool b ) [虚 槽]

设置撤销/恢复是否生效为b。详细情况请参考“undoRedoEnabled”属性。

void QTextEdit::setVerticalAlignment ( VerticalAlignment a ) [虚 槽]

设置当前格式的垂直对齐方式，也就是文本的，为a。 也可以参考color()和paper。

void QTextEdit::setWordWrap ( WordWrap mode ) [虚 槽]

设置自动换行模式为mode。详细情况请参考“wordWrap”属性。

void QTextEdit::setWrapColumnOrWidth ( int ) [虚 槽]

设置将被自动换行的文本的位置（根据自动换行模式决定是象素还是列数）。详细情况请参考“wrapColumnOrWidth”属性。

void QTextEdit::setWrapPolicy ( WrapPolicy policy ) [虚 槽]

设置自动换行策略，是在空白符号还是在任意处为policy。详细情况请参考“wrapPolicy”属性。

QStyleSheet * QTextEdit::styleSheet () const

返回文本编辑中当前使用的QStyleSheet。 也可以参考setStyleSheet()。 实例：helpviewer/helpwindow.cpp。

int QTextEdit::tabStopWidth () const

返回tab stop的象素宽度。详细情况请参考“tabStopWidth”属性。

QString QTextEdit::text () const

返回文本编辑的文本。详细情况请参考“text”属性。

QString QTextEdit::text ( int para ) const

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。 返回para段落的文本。

如果textFormat()为RichText，文本将包含HTML格式标签。

void QTextEdit::textChanged () [信号]

只要文本编辑中的文本发生改变，这个信号就被发射。 也可以参考text和append()。

实例：helpviewer/helpwindow.cpp、qwerty/qwerty.cpp和rot13/rot13.cpp。

QTextCursor * QTextEdit::textCursor () const [保护]

返回文本编辑的文本光标。

警告： QTextCursor不在公有的应用编程接口中，但在一些特殊环境中你也许需要使用它。

TextFormat QTextEdit::textFormat () const

返回文本格式：多信息文本、一般文本或者自动文本。详细情况请参考“textFormat”属性。

bool QTextEdit::underline () const

如果当前格式是有下划线的，返回真，否则返回假。 也可以参考setUnderline()。

void QTextEdit::undo () [虚 槽]

撤销上一次操作。

如果没有操作可以撤销，例如在撤销/恢复历史中没有撤销步骤，那就什么也没发生。

也可以参考undoAvailable(), redo()和undoDepth。

void QTextEdit::undoAvailable ( bool yes ) [信号]

当撤销的可能性发生变化时，这个信号被发射。如果yes为真，那么undo()将会一直工作到undoAvailable( FALSE )下一次被发射为止。 也可以参考undo()和undoDepth。

int QTextEdit::undoDepth () const

返回撤销历史的深度。详细情况请参考“undoDepth”属性。

WordWrap QTextEdit::wordWrap () const

返回自动换行模式。详细情况请参考“wordWrap”属性。

int QTextEdit::wrapColumnOrWidth () const

返回将被自动换行的文本的位置（根据自动换行模式决定是象素还是列数）。详细情况请参考“wrapColumnOrWidth”属性。

WrapPolicy QTextEdit::wrapPolicy () const

返回自动换行策略是在空白符号还是在任意处。详细情况请参考“wrapPolicy”属性。

void QTextEdit::zoomIn ( int range ) [虚 槽]

通过把基本字体大小增大range点并且重新计算所有字体大小来放大文本。这不会改变任何图片的大小。 也可以参考zoomOut()。

void QTextEdit::zoomIn () [虚 槽]

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。 通过把基本字体大小增大1点并且重新计算所有字体大小来放大文本。这不会改变任何图片的大小。 也可以参考zoomOut()。

void QTextEdit::zoomOut ( int range ) [虚 槽]

通过把基本字体大小缩小range点并且重新计算所有字体大小来放大文本。这不会改变任何图片的大小。 也可以参考zoomIn()。

void QTextEdit::zoomOut () [虚 槽]

这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。 通过把基本字体大小缩小1点并且重新计算所有字体大小来放大文本。这不会改变任何图片的大小。 也可以参考zoomIn()。

void QTextEdit::zoomTo ( int size ) [虚 槽]

通过把基本字体大小变为size点并且重新计算所有字体大小来显示文本。这不会改变任何图片的大小。

属性文档

QString documentTitle

这个属性保存的是从文本中分析出的文档标题。

对于PlainText，标题将为空字符串。对于RichText，如果存在，标题将为