当前位置：首页 > news >正文

qt QPlainTextEdit详解

news 2025/8/27 0:23:55

QPlainTextEdit是一个功能强大、易于使用的纯文本编辑器/查看器。它使用与QTextEdit相同的技术和概念，但是为纯文本的处理进行了优化，因此更适合处理大型纯文本文档。QPlainTextEdit不提供富文本编辑功能，如字体、颜色、大小等的格式化，而是专注于纯文本的编辑和显示。

重要方法

setPlainText(const QString &text)：设置文本内容。
toPlainText()：获取当前文本内容。
appendPlainText(const QString &text)：在文本末尾插入文本。
insertPlainText(const QString &text)：在光标位置插入文本。
cut()：剪切选中的文本。
copy()：复制选中的文本。
paste()：粘贴复制的文本。
undo()：撤销上一次操作。
redo()：重做上一次操作。
setReadOnly(bool b)：设置QTextEdit是否为只读模式。在只读模式下，用户无法编辑文本内容。
clear()：清除编辑器内容。
setTextInteractionFlags(Qt::TextInteractionFlags flags)：设置QTextEdit控件如何与用户输入交互。例如，可以设置为只允许通过鼠标选择文本，或允许用户输入并编辑文本等。
setTabChangesFocus(bool b)：设置是否按下Tab键切换文本框焦点。
setTabStopDistance(qreal distance)：设置按下Tab键时插入制表符的间隔距离。
setLineWrapMode(QTextOption::WrapMode mode)：设置QTextEdit编辑器中的换行模式。

重要信号

textChanged()：当文本内容发生变化时发出。
selectionChanged()：当选中的文本发生变化时发出。
cursorPositionChanged()：当光标位置发生变化时发出。
undoAvailable(bool)：当是否可撤销的状态发生改变时发出。
redoAvailable(bool)：当是否可反撤销的状态发生改变时发出。
copyAvailable(bool)：当是否有文本可复制的状态发生改变时发出。
blockCountChanged(int newBlockcount):当文本块数量改变时发射。

#include <QApplication>  
#include <QPlainTextEdit>  
#include <QTextCursor>  
#include <QTextCharFormat>  int main(int argc, char *argv[]) {  QApplication app(argc, argv);  QPlainTextEdit textEdit;  textEdit.setWindowTitle("QPlainTextEdit 示例");  // 设置占位符文本  textEdit.setPlaceholderText("请输入文本内容...");  // 设置文本为只读模式  textEdit.setReadOnly(true);  // 设置文本交互标志为只允许通过鼠标选择文本  textEdit.setTextInteractionFlags(Qt::TextSelectableByMouse);  // 设置按下Tab键时切换文本框焦点（默认为false，即按下Tab键插入制表符）  textEdit.setTabChangesFocus(false);  // 设置制表符间隔距离为80像素  textEdit.setTabStopDistance(80.0);  // 禁用撤销重做功能  textEdit.setUndoRedoEnabled(false);  // 限制总段落数为10  textEdit.setMaximumBlockCount(10);  // 设置换行模式为根据窗口宽度自动换行  textEdit.setLineWrapMode(QPlainTextEdit::WidgetWidth);  // 设置文本内容  textEdit.setPlainText("这是一段示例文本。");  // 显示窗口  textEdit.show();  return app.exec();  
}