强大的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()（这个没有撤销历史，

查看

器

3.

所以更快并且使用更少的内存）来设置文本，

text()根据textFormat()返回一般文本或者多信息

文本。这个模式可以正确显示HTML中一个比较

大的子集。

1.

我们

不

建议使用QTextEdit来创建语法高亮的编辑器，因为现在的应用编程接口对于这个目的

是不够的。我们希望能在以后的发行中发行一个支持语法高亮的更加完整的应用编程接口。

2.

在稍后的Qt发行中计划推出一个更完整的支持设置边白、图片等等的应用编程接口。

3.

Qt 3.1将提供一个日志浏览器模式，它是专门为快速地并且有效使用内存地显示大量的只读文

本而优化的。

我们建议你总是调用setTextFormat()来设置你想使用的模式。如果你是用

AutoText，那么setText()和append()将会试图决定给定的文本是一般文本还是多

信息文本。如果你使用RichText，那么setText()和append()总是假设给定的文本

是多信息文本。insert()简单的插入给定的文本。

QTextEdit在段落和字符上工作。段落就是被自动换行来适应窗口部件的宽度的

被格式化的字符串。默认情况下当读取一般文本时，两个换行符确定一个段落。

一个文档由零或更多个段落组成，索引从0开始。字符是基于每一个段落来被索

引的，也是从0开始。段落中的单字根据段落的alignment()进行对齐。段落被硬

换行分隔。段落中的字符都有自己的属性，例如字体和颜色。

文本编辑文档使用如下概念：





当前格式

-- 这是当前光标位置的格式，如果存在被选择文本，

也是

它的

格式。

当前段落

-- 包含光标的段落。

QTextEdit可以显示图片（使用QMimeSourceFactory）、列表和表格。如果文本

太大以至于不能在文本编辑的视口中查看时，滚动条将会出现。文本编辑可以载

入一般文本和HTML文件（HTML3.2和4的子集）。表现风格和有效标记集由

styleSheet()来定义。自定义标记可以被创建并且被放置到样式单中。可以使用

setStyleSheet()改变样式单，具体情况请参考QStyleSheet。通过图片标记识别的

图片如果它们可以被使用文本编辑的QMimeSourceFactory解释的话就可以被显

示，请参考setMimeSourceFactory()。

如果你想要一个有更多导航的文本浏览器，请使用QTextBrowser。如果你只是

想显示一小条多信息文本，请使用QLabel或者QSimpleRichText。

如果你创建一个新的QTextEdit并且想允许用户编辑多信息文本，请调用

setTextFormat(Qt::RichText)来确保文本被看做多信息文本。（多信息文本使用

HTML标记来设置文本格式属性。关于被支持的HTML标记的信息请参考

QStyleSheet。）如果你不明确地调用setTextFormat()，文本编辑将会猜测文本自

己是多信息文本还是一般文本。这也就是说如果文本看起来像HTML或XML，

它可能被解释为多信息文本，所以你应该调用setTextFormat(Qt::PlainText)来保

护这些文本。

注意我们并不是要为Qt添加一个具有所有特征的网页浏览器窗口部件（因为这

将很容易使Qt的大小加倍并且只有很少的应用程序可以从这里受益）。Qt中的

多信息文本支持是被设计为应用程序提供一个快速、可移植并且有效率地方式来

添加合理的在线帮助工具，并且提供一个多信息文本编辑器的基础。

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

QTextEdit可以显示一个包括表格和图片的大的HTML子集。

文本通过使用setText()来设置或者替换，它删除任何已经存在的文本并且用传递

给setText()调用的文本替换它。如果你使用继承HTML（强制使用

setTextFormat(RichText)）调用setText()，并且然后调用text()，返回的文本可能

有不同的标签，但是它们呈现的都是一样的。文本可以使用insert()、paste()、

pasteSubType()和append()来插入。被添加的文本没有进入撤销历史中，这使得

append()更快并且消耗更少的内存。文本也可以被cut()。整个文本可以使用clear()

来被删除并且被选择的文本可以使用removeSelectedText()来被删除。被选择（被

标记）的文本也可以使用del()来被删除（如果没有文本被选择，这将删除光标

右面的字符）。

可以使用setText()和text()来达到载入和保存文本的目的，例如：

QFile file( fileName ); // 从文件中读取文本

if ( ( IO_ReadOnly ) ) {

QTextStream ts( &file );

textEdit->setText( () );

}

QFile file( fileName ); // 把文本写入到文件中

if ( ( IO_WriteOnly ) ) {

QTextStream ts( &file );

ts << textEdit->text();

textEdit->setModified( FALSE );

}

默认这个文本编辑会在空白符号处自动换行来适应文本编辑窗口部件。

setWordWrap()函数用来指定你想要的自动换行方式，或者如果你不像要任何自

动换行，请使用NoWrap。调用setWordWrap()来设置固定的像素宽度

FixedPixelWidth，或者由setWrapColumnOrWidth()确定的像素或者列数的字符列

数（例如80列）FixedColumnWidth。如果你是用自动换行来适应窗口部件的宽

度WidgetWidth，你可以使用setWrapPolicy()来指定是在空白符号或者任何地方

自动换行。

背景色的设置与其它窗口部件不同，使用setPaper()。你可以指定画刷风格是一

个普通颜色或者一个复杂的像素映射。

超文本链接可以自动加上下划线，这个可以通过setLinkUnderline()来改变。tab

stop宽度可以使用setTabStopWidth()来设置。

zoomIn()和zoomOut()函数能够用来通过增加（对于zoomOut()是减少）使用的点

的大小来重新定义文本的大小。

lines()函数返回文本中的行数并且paragraphs()返回段落数。特定段落中的函数可

以通过linesOfParagraph()返回。整个文本的字符长度可以通过length()返回。

你可以滚动到文本中的一个锚，也就是通过scrollToAnchor()到达

name="anchor">。find()函数可以被用来找到和选择文本中的给定字符串。

只读的QTextEdit提供了和（废弃的）QTextEdit相同的功能。（QTextView仍

被提供用来保证旧代码的兼容性。）

只读的键绑定

当QTextEdit被使用的时候，只读的键绑定仅限于浏览，并且文本只能被鼠标选

定：

按键

UpArrow 向上移动一行

操作

DownArrow 向下移动一行

LeftArrow 向左移动一个字符

RightArrow 向右移动一个字符

PageUp 向上移动一页（视口）

PageDown 向下移动一页（视口）

Home

End

移动到文本开始处

移动到文本结束处

Shift+Wheel 水平的滚动文本（Wheel就是鼠标滚轮）

Ctrl+Wheel 缩放文本

文本编辑也可以提供一些元信息。例如，documentTitle()函数将返回来自HTML

的