标记内返回文本。

注意：仅当font-size未设置为固定大小时，才放大HTML文档。

Using QTextEdit as an Editor — 使用QTextEdit作为编辑器

有关将QTextEdit用作显示窗口小部件的所有信息也适用于此。

当前char格式的属性通过setFontItalic()，setFontWeight()，setFontUnderline()，setFontFamily()，setFontPointSize()，setTextColor()和setCurrentFont()进行设置。 当前段落的对齐方式通过setAlignment()设置。

文本的选择由QTextCursor类处理，该类提供了用于创建选择，检索文本内容或删除选择的功能。 您可以使用textCursor()方法检索与用户可见的光标对应的对象。 如果要在QTextEdit中设置选择，只需在QTextCursor对象上创建一个选择，然后使用setTextCursor()使该光标成为可见光标。 可以使用copy()将所选内容复制到剪贴板，或使用cut()剪切到剪贴板。 可以使用selectAll()选择整个文本。

当光标移动并且基础格式属性更改时，会发出currentCharFormatChanged()信号以在新光标位置反映新属性。

每当文本更改时(由于setText()或通过编辑器本身)，都会发出textChanged()信号。

QTextEdit包含一个QTextDocument对象，可以使用document()方法检索该对象。 您也可以使用setDocument()设置自己的文档对象。

QTextDocument提供了一个isModified()函数，如果自加载文本以来或自上次以false作为参数调用setModified以来对文本进行了修改，则它将返回true。 另外，它提供了撤消和重做的方法。

Drag and Drop — 拖放

QTextEdit还支持自定义拖放行为。 默认情况下，当用户将这些MIME类型的数据拖放到文档上时，QTextEdit将插入纯文本，HTML和富文本格式。 重新实现canInsertFromMimeData()和insertFromMimeData()以添加对其他MIME类型的支持。

例如，要允许用户将图像拖放到QTextEdit上，可以通过以下方式实现这些功能：

我们通过返回true添加对图像MIME类型的支持。 对于所有其他MIME类型，我们使用默认实现。

我们从MIME源保存的QVariant中解压缩图像，并将其作为资源插入文档中。

Editing Key Bindings — 编辑按键绑定

为编辑而实现的键绑定列表：

Keypresses Action

Backspace 删除光标左边的字符。

Delete 删除光标右边的字符。

Ctrl+C 将选定的文本复制到剪贴板。

Ctrl+Insert 将选定的文本复制到剪贴板。

Ctrl+K 删除到行尾。

Ctrl+V 将剪贴板文本粘贴到文本编辑中。

Shift+Insert 剪贴板文本粘贴到文本编辑中。

Ctrl+X 删除选定的文本并将其复制到剪贴板。

Shift+Delete 删除选定的文本并将其复制到剪贴板。

Ctrl+Z 重做上一个操作。

Ctrl+Y 重做上一个操作。

Left 移动光标向左一个字符。

Ctrl+Left 将光标向左移动一个单词。

Right 将光标向右移动一个字符。

Ctrl+Right 将光标向右移动一个单词。

Up 将光标向上移动一行。

Down 将光标向下移动一行。

PageUp 将光标向上移动一页。

PageDown 将光标向下移动一页。

Home 将光标移动到行的开头。

Ctrl+Home 将光标移动到文本的开头。

End 将光标移动到行尾。

Ctrl+End 将光标移动到文本的末尾。

Alt+Wheel 水平滚动页面(滚轮是鼠标滚轮)。

要选择(标记)文本，请在按住Shift键的同时按下移动键之一，例如Shift + Right将选择右侧的字符，而Shift + Ctrl + Right将选择右侧的单词，依此类推。

另请参见QTextDocument，QTextCursor，应用示例，语法突出显示示例和RTF处理。

Prpperties – 属性

acceptRichText : bool

此属性保存文本编辑是否接受用户的富文本插入

当此属性设置为false时，文本编辑将仅接受来自用户的纯文本输入。 例如通过剪贴板或拖放。

此属性的默认值为true。

此属性在Qt 4.1中引入。

访问函数:

bool acceptRichText() const

void setAcceptRichText(bool accept)

autoFormatting : AutoFormatting

此属性包含已启用的一组自动格式设置功能

该值可以是AutoFormattingFlag枚举中值的任何组合。 默认值为自动无。 选择“自动全部”以启用所有自动格式化。

当前，唯一提供的自动格式设置功能是AutoBulletList。 Qt的未来版本可能会提供更多功能。

访问函数：

QtextEdit::AutoFormatting autoFormatting() const

void setAutoFormatting(QtextEdit::AutoFormatting features)

cursorWidth : int

此属性指定光标的宽度(以像素为单位)。 预设值是1。

此属性在Qt 4.2中引入。

访问函数：

int cursorWidth() const

void setCursorWidth(int width)

document : QTextDocument*

此属性保存文本编辑器的基础文档。

注意：除非它是文档的父对象，否则编辑器不会拥有该文档的所有权。 提供的文档的父对象仍然是该对象的所有者。 如果先前分配的文档是编辑器的子级，则将其删除。

访问功能：

QtextDocument * document() const

void setDocument(QtextDocument * document)

documentTitle : QString

此属性保存从文本解析的文档的标题。

默认情况下，对于新创建的空文档，此属性包含一个空字符串。

访问函数：

QString documentTitle() const

void setDocumentTitle(const QString & title)

html : QString

此属性为文本编辑的文本提供HTML界面。

toHtml()以html形式返回文本编辑的文本。

setHtml()更改文本编辑的文本。 删除所有先前的文本，并清除撤消/重做历史记录。 输入的文本被解释为html格式的富文本。 除非textCursor()已经在文档的开头，否则currentCharFormat()也会被重置。

注意：在创建包含HTML的QString并将其传递给setHtml()时，调用者有责任确保正确解码文本。

默认情况下，对于新创建的空文档，此属性包含用于描述没有正文文本的HTML 4.0文档的文本。

访问功能：

QString toHtml() const

void setHtml(const QString & text)

通知者信号：

void textChanged()

另请参见受支持的HTML子集和plainText。

lineWrapColumnOrWidth : int

此属性保存文本将被换行的位置(以像素或列为单位，具体取决于换行模式)

如果换行模式为FixedPixelWidth，则该值是从文本编辑的左边缘起应包裹文本的像素数。 如果换行模式为FixedColumnWidth，则该值是从文本编辑的左边缘起应被换行的列号(以字符列为单位)。

默认情况下，此属性的值为0。

访问功能：

int lineWrapColumnOrWidth() const

void setLineWrapColumnOrWidth(int w)

另请参见lineWrapMode。

lineWrapMode : LineWrapMode

此属性保留换行模式

默认模式是WidgetWidth，它使单词被包裹在文本编辑的右边缘。 包装发生在空白处，使整个单词保持完整。 如果要在单词内进行换行，请使用setWordWrapMode()。 如果将固定模式设置为FixedPixelWidth或FixedColumnWidth，则还应使用所需宽度调用setLineWrapColumnOrWidth()。

访问功能：

QtextEdit::LineWrapMode lineWrapMode() const

void setLineWrapMode(QtextEdit::LineWrapMode mode)

另请参见lineWrapColumnOrWidth。

markdown : QString

此属性为文本编辑的文本提供Markdown界面。

toMarkdown()将文本编辑的文本作为“纯” Markdown返回，没有任何嵌入式HTML格式。 QTextDocument支持的某些功能(例如使用特定的颜色和命名的字体)无法用“纯” Markdown表示，因此将省略它们。

setMarkdown()更改文本编辑的文本。 删除所有先前的文本，并清除撤消/重做历史记录。 输入文本被解释为Markdown格式的富文本。

markdown字符串中包含的HTML的解析与setHtml中的处理相同； 但是，不支持HTML块内的Markdown格式。

可以通过features参数启用或禁用解析器的某些功能：

Constant 描述

MarkdownNoHTML Markdown文本中的任何HTML标签都将被丢弃

MarkdownDialectCommonMark 解析器仅支持CommonMark标准化的功能

MarkdownDialectGitHub 解析器支持GitHub语法

默认值为MarkdownDialectGitHub。

访问函数：

QString toMarkdowm(QtextDocument::MarkdownFeatures features = QtextDocument::MarkdownDialectGitHub) const

void setMarkdown(const QString & markdown)

overwriteMode : bool

此属性保存用户输入的文本是否将覆盖现有文本

与许多文本编辑器一样，文本编辑器小部件可以配置为使用用户输入的新文本来插入或覆盖现有文本。

如果此属性为true，则现有文本将被新文本按字符替换； 否则，将文本插入光标位置，替换现有文本。

默认情况下，此属性为false(新文本不会覆盖现有文本)。

此属性在Qt 4.1中引入。

访问函数：

bool overwriteMode() const

void setOverwriteMode(bool overwrite)

placeholderText : QString

此属性保存编辑器占位符文本

设置此属性会使编辑器在document()为空的情况下显示灰色的占位符文本。

默认情况下，此属性包含一个空字符串。

此属性在Qt 5.2中引入。

访问函数：

QString placeholderText() const

void setPlaceholderText(const QString & placeholderText)

另请参见document()。

plainText : QString

此属性获取并将文本编辑器的内容设置为纯文本。 设置该属性后，先前的内容将被删除，撤消/重做历史记录将被重置。 除非textCursor()已经在文档的开头，否则currentCharFormat()也会被重置。

如果文本编辑具有其他内容类型，则在调用toPlainText()时不会将其替换为纯文本。 唯一的例外是不间断空间nbsp;，它将转换为标准空间。

默认情况下，对于没有内容的编辑器，此属性包含一个空字符串。

此属性在Qt 4.3中引入。

访问函数：

QString toPlainText() const

void setPlainText(const QString & text)

另请参见html。

readOnly : bool

此属性保存文本编辑是否为只读

在只读文本编辑中，用户只能浏览文本并选择文本。 修改文本是不可能的。

此属性的默认值为false。

访问函数：

bool isReadOnly() const

void setReadOnly(bool ro)

tabChangesFocus : bool

此属性保存Tab是否更改焦点还是被接受为输入

在某些情况下，文本编辑不应允许用户使用Tab键输入制表符或更改缩进，因为这会破坏焦点链。 默认为false。

访问功能：

bool tabChangeFocus() const

void setTabChangesFocus(cool b)

tabStopDistance : qreal

此属性保存制表符停止距离(以像素为单位)

默认情况下，此属性包含80像素的值。

此属性在Qt 5.10中引入。

访问功能：

qreal tabStopDistance() const

void setTabStopDistance(qreal distance)

textInteractionFlags : Qt::TextInteractionFlags

指定窗口小部件应如何与用户输入交互。

默认值取决于QTextEdit是只读的还是可编辑的，以及它是否是QTextBrowser。

此属性在Qt 4.2中引入。

访问函数：

Qt::TextInteractionFlags textInteractionFlags() const

void setTextInteractionFlags(Qt::TextInteractionFlags flags)

undoRedoEnabled : bool

此属性保存是否启用撤消和重做

如果此属性为true，并且存在可以撤消(或重做)的操作，则用户只能撤消或重做操作。

访问函数：

bool isUndoRedoEnabled() const

void setUndoRedoEnabled(bool enable)

wordWrapMode : QTextOption::WrapMode

此属性保留QTextEdit在按文字换行时将使用的模式

默认情况下，此属性设置为QTextOption :: WrapAtWordBoundaryOrAnywhere。

访问功能：

QtextOption::WrapMode wordWrapMode() const

void setWordWrapMode(QtextOption::WrapMode policy)

另请参见QTextOption :: WrapMode。

Public Functions – 公共函数

QTextEdit::QTextEdit(const QString &text, QWidget *parent = nullptr)

构造一个带有父parent的QTextEdit。 文本编辑将显示text。 文本被解释为html。

QTextEdit::QTextEdit(QWidget *parent = nullptr)

构造一个带有父parent的空QTextEdit。

QTextEdit::~QTextEdit()

析构函数。

acceptRichText : bool

此属性保存文本编辑是否接受用户的富文本插入

当此属性设置为false时，文本编辑将仅接受来自用户的纯文本输入。 例如通过剪贴板或拖放。

此属性的默认值为true。

此属性在Qt 4.1中引入。

访问函数:

bool acceptRichText() const

void setAcceptRichText(bool accept)

Qt::Alignment QTextEdit::alignment() const

返回当前段落的对齐方式。

另请参见setAlignment()。

QString QTextEdit::anchorAt(const QPoint &pos) const

返回位置pos处锚点的引用，如果该点不存在锚，则返回一个空字符串。

autoFormatting : AutoFormatting

此属性包含已启用的一组自动格式设置功能

该值可以是AutoFormattingFlag枚举中值的任何组合。 默认值为自动无。 选择“自动全部”以启用所有自动格式化。

当前，唯一提供的自动格式设置功能是AutoBulletList。 Qt的未来版本可能会提供更多功能。

访问函数：

QtextEdit::AutoFormatting autoFormatting() const

void setAutoFormatting(QtextEdit::AutoFormatting features)

bool QTextEdit::canPaste() const

返回是否可以将文本从剪贴板粘贴到textedit中。

此功能在Qt 4.2中引入。

QMenu *QTextEdit::createStandardContextMenu()

此功能创建标准上下文菜单，当用户使用鼠标右键单击文本编辑时将显示该菜单。 从默认的contextMenuEvent()处理函数中调用它。 弹出菜单的所有权已转移给调用者。

我们建议您改用createStandardContextMenu(QPoint)版本，该版本将启用对用户单击位置敏感的操作。

QMenu *QTextEdit::createStandardContextMenu(const QPoint &position)

此功能创建标准上下文菜单，当用户使用鼠标右键单击文本编辑时将显示该菜单。 从默认的contextMenuEvent()处理函数中调用它，并采用鼠标单击所在的文档坐标中的位置。 这可以启用对用户单击位置敏感的动作。 弹出菜单的所有权已转移给调用者。

此功能在Qt 4.4中引入。

QTextCharFormat QTextEdit::currentCharFormat() const

返回插入新文本时使用的char格式。

另请参见setCurrentCharFormat()。

QFont QTextEdit::currentFont() const

返回当前格式的字体。

另请参见setCurrentFont()，setFontFamily()和setFontPointSize()。

QTextCursor QTextEdit::cursorForPosition(const QPoint &pos) const

在位置pos(在视口坐标中)返回QTextCursor。

QRect QTextEdit::cursorRect(const QTextCursor &cursor) const

返回一个包含cursor的矩形(在视口坐标中)。

QRect QTextEdit::cursorRect() const

返回一个矩形(在视口坐标中)，该矩形包括文本编辑的光标。

cursorWidth : int

此属性指定光标的宽度(以像素为单位)。 预设值是1。

此属性在Qt 4.2中引入。

访问函数：

int cursorWidth() const

void setCursorWidth(int width)

document : QTextDocument*

此属性保存文本编辑器的基础文档。

注意：除非它是文档的父对象，否则编辑器不会拥有该文档的所有权。 提供的文档的父对象仍然是该对象的所有者。 如果先前分配的文档是编辑器的子级，则将其删除。

访问功能：

QtextDocument * document() const

void setDocument(QtextDocument * document)

documentTitle : QString

此属性保存从文本解析的文档的标题。

默认情况下，对于新创建的空文档，此属性包含一个空字符串。

访问函数：

QString documentTitle() const

void setDocumentTitle(const QString & title)

void QTextEdit::ensureCursorVisible()

如有必要，可通过滚动文本编辑来确保光标可见。

QList QTextEdit::extraSelections() const

返回先前设置的其他选择。

此功能在Qt 4.2中引入。

另请参见setExtraSelections()。

bool QTextEdit::find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

使用给定的options查找字符串的下一个匹配项exp。 如果找到exp，则返回true，并更改光标以选择匹配项；否则，返回true。 否则返回false。

bool QTextEdit::find(const QRegExp &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

这是一个过载函数。

使用给定的选项查找与正则表达式exp匹配的下一个匹配项。 对于此重载，将忽略QTextDocument :: FindCaseSensitively选项，而应使用QRegExp :: caseSensitivity。

如果找到匹配项，则返回true，并更改光标以选择匹配项；否则，返回true。 否则返回false。

此功能在Qt 5.3中引入。

bool QTextEdit::find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

这是一个过载函数。

使用给定的选项查找与正则表达式exp匹配的下一个匹配项。 对于此重载，将忽略QTextDocument :: FindCaseSensitively选项，而应使用QRegularExpression :: CaseInsensitiveOption。

如果找到匹配项，则返回true，并更改光标以选择匹配项；否则，返回true。 否则返回false。

此功能在Qt 5.13中引入。

QString QTextEdit::fontFamily() const

返回当前格式的字体系列。

另请参见setFontFamily()，setCurrentFont()和setFontPointSize()。

bool QTextEdit::fontItalic() const

如果当前格式的字体为斜体，则返回true；否则，返回true。 否则返回false。

另请参见setFontItalic()。

qreal QTextEdit::fontPointSize() const

返回当前格式的字体的磅值。

另请参见setFontFamily()，setCurrentFont()和setFontPointSize()。

bool QTextEdit::fontUnderline() const

如果当前格式的字体带下划线，则返回true；否则，返回true。 否则返回false。

另请参见setFontUnderline()。

int QTextEdit::fontWeight() const

返回当前格式的字体粗细。

另请参见setFontWeight()，setCurrentFont()，setFontPointSize()和QFont :: Weight。

readOnly : bool

此属性保存文本编辑是否为只读

在只读文本编辑中，用户只能浏览文本并选择文本。 修改文本是不可能的。

此属性的默认值为false。

访问函数：

bool isReadOnly() const

void setReadOnly(bool ro)

undoRedoEnabled : bool

此属性保存是否启用撤消和重做

如果此属性为true，并且存在可以撤消(或重做)的操作，则用户只能撤消或重做操作。

访问函数：

bool isUndoRedoEnabled() const

void setUndoRedoEnabled(bool enable)

lineWrapColumnOrWidth : int

此属性保存文本将被换行的位置(以像素或列为单位，具体取决于换行模式)

如果换行模式为FixedPixelWidth，则该值是从文本编辑的左边缘起应包裹文本的像素数。 如果换行模式为FixedColumnWidth，则该值是从文本编辑的左边缘起应被换行的列号(以字符列为单位)。

默认情况下，此属性的值为0。

访问功能：

int lineWrapColumnOrWidth() const

void setLineWrapColumnOrWidth(int w)

另请参见lineWrapMode。

lineWrapMode : LineWrapMode

此属性保留换行模式

默认模式是WidgetWidth，它使单词被包裹在文本编辑的右边缘。 包装发生在空白处，使整个单词保持完整。 如果要在单词内进行换行，请使用setWordWrapMode()。 如果将固定模式设置为FixedPixelWidth或FixedColumnWidth，则还应使用所需宽度调用setLineWrapColumnOrWidth()。

访问功能：

QtextEdit::LineWrapMode lineWrapMode() const

void setLineWrapMode(QtextEdit::LineWrapMode mode)

另请参见lineWrapColumnOrWidth

QVariant QTextEdit::loadResource(int type, const QUrl &name)

加载由给定类型和名称指定的资源。

该函数是QTextDocument :: loadResource()的扩展。

注意：可以通过元对象系统和QML调用此函数。 请参阅Q_INVOKABLE。

另请参见QTextDocument :: loadResource()。

void QTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

通过在编辑器的光标上调用QTextCursor :: mergeCharFormat，将修饰符中指定的属性合并为当前字符格式。 如果编辑器具有选择，则修饰符的属性将直接应用于选择。

另请参见QTextCursor :: mergeCharFormat()。

void QTextEdit::moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor)

通过执行给定的操作来移动光标。

如果mode为QTextCursor :: KeepAnchor，则光标选择其移过的文本。 这与用户按住Shift键并使用光标键移动光标时获得的效果相同。

此功能在Qt 4.2中引入。

另请参见QTextCursor :: movePosition()。

overwriteMode : bool

此属性保存用户输入的文本是否将覆盖现有文本

与许多文本编辑器一样，文本编辑器小部件可以配置为使用用户输入的新文本来插入或覆盖现有文本。

如果此属性为true，则现有文本将被新文本按字符替换； 否则，将文本插入光标位置，替换现有文本。

默认情况下，此属性为false(新文本不会覆盖现有文本)。

此属性在Qt 4.1中引入。

访问函数：

bool overwriteMode() const

void setOverwriteMode(bool overwrite)

placeholderText : QString

此属性保存编辑器占位符文本

设置此属性会使编辑器在document()为空的情况下显示灰色的占位符文本。

默认情况下，此属性包含一个空字符串。

此属性在Qt 5.2中引入。

访问函数：

QString placeholderText() const

void setPlaceholderText(const QString & placeholderText)

另请参见document()。

void QTextEdit::print(QPagedPaintDevice *printer) const

便捷功能，可将文本编辑的文档打印到给定的打印机上。 这等效于直接在文档上调用print方法，除了此函数还支持QPrinter :: Selection作为打印范围。

此功能在Qt 4.3中引入。

另请参见QTextDocument :: print()。

acceptRichText : bool

此属性保存文本编辑是否接受用户的富文本插入

当此属性设置为false时，文本编辑将仅接受来自用户的纯文本输入。 例如通过剪贴板或拖放。

此属性的默认值为true。

此属性在Qt 4.1中引入。

访问函数:

bool acceptRichText() const

void setAcceptRichText(bool accept)

void QTextEdit::setCurrentCharFormat(const QTextCharFormat &format)

通过在编辑器的光标上调用QTextCursor :: setCharFormat()来设置在插入新文本以设置格式时使用的char格式。 如果编辑器具有选择，则将char格式直接应用于选择。

另请参见currentCharFormat()。

cursorWidth : int

此属性指定光标的宽度(以像素为单位)。 预设值是1。

此属性在Qt 4.2中引入。

访问函数：

int cursorWidth() const

void setCursorWidth(int width)

void QTextEdit::setExtraSelections(const QList &selections)

此功能允许使用给定的颜色临时标记文档中的某些区域，指定为选择区域。 例如，在编程编辑器中用给定的背景色标记整行文本以指示断点的存在，这可能很有用。

此功能在Qt 4.2中引入。

另请参见QTextEdit :: ExtraSelection和extraSelections()。

tabStopDistance : qreal

此属性保存制表符停止距离(以像素为单位)

默认情况下，此属性包含80像素的值。

此属性在Qt 5.10中引入。

访问功能：

qreal tabStopDistance() const

void setTabStopDistance(qreal distance)

tabChangesFocus : bool

此属性保存Tab是否更改焦点还是被接受为输入

在某些情况下，文本编辑不应允许用户使用Tab键输入制表符或更改缩进，因为这会破坏焦点链。 默认为false。

访问功能：

bool tabChangeFocus() const

void setTabChangesFocus(cool b)

void QTextEdit::setTextCursor(const QTextCursor &cursor)

设置可见光标。

另请参见textCursor()。

textInteractionFlags : Qt::TextInteractionFlags

指定窗口小部件应如何与用户输入交互。

默认值取决于QTextEdit是只读的还是可编辑的，以及它是否是QTextBrowser。

此属性在Qt 4.2中引入。

访问函数：

Qt::TextInteractionFlags textInteractionFlags() const

void setTextInteractionFlags(Qt::TextInteractionFlags flags)

wordWrapMode : QTextOption::WrapMode

此属性保留QTextEdit在按文字换行时将使用的模式

默认情况下，此属性设置为QTextOption :: WrapAtWordBoundaryOrAnywhere。

访问功能：

QtextOption::WrapMode wordWrapMode() const

void setWordWrapMode(QtextOption::WrapMode policy)

另请参见QTextOption :: WrapMode。

QColor QTextEdit::textBackgroundColor() const

返回当前格式的文本背景色。

此功能在Qt 4.4中引入。

另请参见setTextBackgroundColor()。

QColor QTextEdit::textColor() const

返回当前格式的文本颜色。

另请参见setTextColor()。

QTextCursor QTextEdit::textCursor() const

返回表示当前可见光标的QTextCursor的副本。 请注意，对返回的游标所做的更改不会影响QTextEdit的游标。 使用setTextCursor()更新可见光标。

另请参见setTextCursor()。

html : QString

此属性为文本编辑的文本提供HTML界面。

toHtml()以html形式返回文本编辑的文本。

setHtml()更改文本编辑的文本。 删除所有先前的文本，并清除撤消/重做历史记录。 输入的文本被解释为html格式的富文本。 除非textCursor()已经在文档的开头，否则currentCharFormat()也会被重置。

注意：在创建包含HTML的QString并将其传递给setHtml()时，调用者有责任确保正确解码文本。

默认情况下，对于新创建的空文档，此属性包含用于描述没有正文文本的HTML 4.0文档的文本。

访问功能：

QString toHtml() const

void setHtml(const QString & text)

通知者信号：

void textChanged()

另请参见受支持的HTML子集和plainText。

markdown : QString

此属性为文本编辑的文本提供Markdown界面。

toMarkdown()将文本编辑的文本作为“纯” Markdown返回，没有任何嵌入式HTML格式。 QTextDocument支持的某些功能(例如使用特定的颜色和命名的字体)无法用“纯” Markdown表示，因此将省略它们。

setMarkdown()更改文本编辑的文本。 删除所有先前的文本，并清除撤消/重做历史记录。 输入文本被解释为Markdown格式的富文本。

markdown字符串中包含的HTML的解析与setHtml中的处理相同； 但是，不支持HTML块内的Markdown格式。

可以通过features参数启用或禁用解析器的某些功能：

Constant 描述

MarkdownNoHTML Markdown文本中的任何HTML标签都将被丢弃

MarkdownDialectCommonMark 解析器仅支持CommonMark标准化的功能

MarkdownDialectGitHub 解析器支持GitHub语法

默认值为MarkdownDialectGitHub。

访问函数：

QString toMarkdowm(QtextDocument::MarkdownFeatures features = QtextDocument::MarkdownDialectGitHub) const

void setMarkdown(const QString & markdown)

QString QTextEdit::toPlainText() const

QString QTextEdit :: toPlainText()常量

以纯文本形式返回文本编辑的文本。

注意：属性plainText的Getter函数。

另请参见QTextEdit :: setPlainText()。

Public Slots – 公共插槽

void QTextEdit::append(const QString &text)

将带有text的新段落追加到文本编辑的末尾。

注意：附加的新段落将具有与当前段落相同的字符格式和块格式，具体取决于光标的位置。

另请参见currentCharFormat()和QTextCursor :: blockFormat()。

void QTextEdit::clear()

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

注意：

 撤消/重做历史也被清除。

 除非textCursor()已在文档开头，否则将重置currentCharFormat()。

另请参见cut()，setPlainText()和setHtml()。

void QTextEdit::copy()

将所有选定的文本复制到剪贴板。

另请参见copyAvailable()。

void QTextEdit::cut()

将所选文本复制到剪贴板，然后将其从文本编辑中删除。

如果没有选定的文本，则不会发生任何事情。

另请参见copy()和paste()。

void QTextEdit::insertHtml(const QString &text)

方便位置，可在当前光标位置插入假定为html格式的文本。

它等效于：

注意：将此功能与样式表一起使用时，样式表将仅应用于文档中的当前块。 为了在整个文档中应用样式表，请改用QTextDocument :: setDefaultStyleSheet()。

void QTextEdit::insertPlainText(const QString &text)

方便插槽，用于在当前光标位置插入文本。

相当于

void QTextEdit::paste()

将剪贴板中的文本粘贴到当前光标位置的文本编辑中。

如果剪贴板中没有文本，则不会发生任何事情。

要更改此函数的行为，即修改QTextEdit可以粘贴的内容以及粘贴方式，请重新实现虚拟canInsertFromMimeData()和insertFromMimeData()函数。

另请参见cut()和copy()。

void QTextEdit::redo()

重做上一个操作。

如果没有要重做的操作，即在撤消/重做历史中没有重做步骤，则什么也不会发生。

此功能在Qt 4.2中引入。

另请参见undo()。

void QTextEdit::scrollToAnchor(const QString &name)

滚动文本编辑，以便显示具有给定name的锚点； 如果name为空，已经可见或找不到，则不执行任何操作。

void QTextEdit::selectAll()

选择所有文本。

另请参见copy()，cut()和textCursor()。

void QTextEdit::setAlignment(Qt::Alignment a)

将当前段落的对齐方式设置为a。 有效的对齐方式为Qt :: AlignLeft，Qt :: AlignRight，Qt :: AlignJustify和Qt :: AlignCenter(水平居中)。

另请参见alignment()。

void QTextEdit::setCurrentFont(const QFont &f)

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

另请参见currentFont()，setFontPointSize()和setFontFamily()。

void QTextEdit::setFontFamily(const QString &fontFamily)

将当前格式的字体系列设置为fontFamily。

另请参见fontFamily()和setCurrentFont()。

void QTextEdit::setFontItalic(bool italic)

如果italic为true，则将当前格式设置为斜体；否则为0。 否则将当前格式设置为非斜体。

另请参见fontItalic()。

void QTextEdit::setFontPointSize(qreal s)

将当前格式的磅值设置为s。

注意，如果s为零或负，则此函数的行为未定义。

另请参见fontPointSize()，setCurrentFont()和setFontFamily()。

void QTextEdit::setFontUnderline(bool underline)

如果underline为true，则将当前格式设置为下划线。 否则将当前格式设置为非下划线。

另请参见fontUnderne()。

void QTextEdit::setFontWeight(int weight)

将当前格式的字体权重设置为给定的weight，其中使用的值在QFont :: Weight枚举定义的范围内。

另请参见fontWeight()，setCurrentFont()和setFontFamily()。

html : QString

此属性为文本编辑的文本提供HTML界面。

toHtml()以html形式返回文本编辑的文本。

setHtml()更改文本编辑的文本。 删除所有先前的文本，并清除撤消/重做历史记录。 输入的文本被解释为html格式的富文本。 除非textCursor()已经在文档的开头，否则currentCharFormat()也会被重置。

注意：在创建包含HTML的QString并将其传递给setHtml()时，调用者有责任确保正确解码文本。

默认情况下，对于新创建的空文档，此属性包含用于描述没有正文文本的HTML 4.0文档的文本。

访问功能：

QString toHtml() const

void setHtml(const QString & text)

通知者信号：

void textChanged()

另请参见受支持的HTML子集和plainText。

markdown : QString

此属性为文本编辑的文本提供Markdown界面。

toMarkdown()将文本编辑的文本作为“纯” Markdown返回，没有任何嵌入式HTML格式。 QTextDocument支持的某些功能(例如使用特定的颜色和命名的字体)无法用“纯” Markdown表示，因此将省略它们。

setMarkdown()更改文本编辑的文本。 删除所有先前的文本，并清除撤消/重做历史记录。 输入文本被解释为Markdown格式的富文本。

markdown字符串中包含的HTML的解析与setHtml中的处理相同； 但是，不支持HTML块内的Markdown格式。

可以通过features参数启用或禁用解析器的某些功能：

Constant 描述

MarkdownNoHTML Markdown文本中的任何HTML标签都将被丢弃

MarkdownDialectCommonMark 解析器仅支持CommonMark标准化的功能

MarkdownDialectGitHub 解析器支持GitHub语法

默认值为MarkdownDialectGitHub。

访问函数：

QString toMarkdowm(QtextDocument::MarkdownFeatures features = QtextDocument::MarkdownDialectGitHub) const

void setMarkdown(const QString & markdown)

void QTextEdit::setPlainText(const QString &text)

将文本编辑的文本更改为字符串文本。 之前的所有文字都将被删除。

注意：

 text被解释为纯文本。

 撤消/重做历史也被清除。

 除非textCursor()已在文档开头，否则将重置currentCharFormat()。

注意：属性plainText的Setter函数。

另请参见toPlainText()。

void QTextEdit::setText(const QString &text)

设置文本编辑的text。 文本可以是纯文本或HTML，并且文本编辑将尝试猜测正确的格式。

直接使用setHtml()或setPlainText()可以避免文本编辑的猜测。

此功能在Qt 4.2中引入。

另请参见toPlainText()和toHtml()。

void QTextEdit::setTextBackgroundColor(const QColor &c)

将当前格式的文本背景色设置为c。

此功能在Qt 4.4中引入。

另请参见textBackgroundColor()。

void QTextEdit::setTextColor(const QColor &c

将当前格式的文本颜色设置为c。

另请参见textColor()。

void QTextEdit::undo()

撤消上一个操作。

如果没有撤消操作，即撤消/重做历史中没有撤消步骤，则不会发生任何事情。

此功能在Qt 4.2中引入。

另请参见redo()。

void QTextEdit::zoomIn(int range = 1)

通过扩大基本字体尺寸range点并将所有字体大小重新计算为新大小来放大文本。 这不会更改任何图像的大小。

另请参见zoomOut()。

void QTextEdit::zoomOut(int range = 1)

通过缩小基本字体大小range点并将所有字体大小重新计算为新大小来缩小文本。 这不会更改任何图像的大小。

另请参见zoomIn()。

Protected Functions – 保护函数

bool QTextEdit::canInsertFromMimeData(const QMimeData *source) const

如果可以解码由source指定的MIME数据对象的内容并将其插入文档中，则此函数返回true。 例如，在拖动操作期间鼠标进入该小部件并且需要确定是否有可能接受拖放操作时，将调用此方法。

重新实现此功能以启用对其他MIME类型的拖放支持。

QMimeData *QTextEdit::createMimeDataFromSelection() const

此函数返回一个新的MIME数据对象，以表示文本编辑的当前选择内容。 当选择需要封装到新的QMimeData对象中时，将调用此方法。 例如，当开始拖放操作或将数据复制到剪贴板时。

如果重新实现此功能，请注意，返回的QMimeData对象的所有权将传递给调用方。 可以通过使用textCursor()函数来检索选择。

void QTextEdit::insertFromMimeData(const QMimeData *source)

此函数将由source指定的MIME数据对象的内容插入到当前光标位置的文本编辑中。 每当由于剪贴板粘贴操作而插入文本时，或者当文本编辑接受来自拖放操作的数据时，都会调用该方法。

重新实现此功能以启用对其他MIME类型的拖放支持。