QPlainTextEdit 是一个多行文本编辑器,用于显示和编辑多行简单文本。另外,还有一个 QTextEdit 组件,是一个所见即所得的可以编辑带格式文本的组件,以 HTML 格式标记符定义文本格式。
实例 samp4_6 演示 QPlainTextEdit(和
QComboBox
)的使用,其运行时界面如图 1 所示。
图 1 实例运行界面
从《
QComboBox
》一节中的代码实现己经看出,使用 QPlainTextEdit::appendPlainText(const QString 函数就可以向 PlainTextEdit 组件添加一行字符串。
QPlainTextEdit 提供 cut()、copy()、paste()、undo()、redo()、clear()、selectAll() 等标准编辑功能的槽函数,QPlainTextEdit 还提供一个标准的右键快捷菜单。
逐行读取文字内容
如果要将 QPlainTextEdit 组件里显示的所有文字读取出来,有一个简单的函数 toPlainText() 可以将全部文字内容输出为一个字符串,其定义如下:
QString QPlainTextEdit::toPlainText() const
但是如果要逐行读取 QPlainTextEdit 组件里的字符串,则稍微麻烦一点。
下面是图 1 窗口中“文本框内容添加到 ComboBox”按钮的响应代码,它将 plainTextEdit 里的每一行作为一个项添加到 comboBox 里:
- void Widget::on_btnToComboBox_clicked()
-
{
- //plainTextEdit的内容逐行添加为comboBox的项
- QTextDocument* doc=ui->plainTextEdit->document () ; //文本对象
- int cnt=doc->blockCount () ;//回车符是一个 block
- QIcon icon(M:/images/icons/aim.ico”);
- ui->comboBox->clear();
- for (int i=0; i<cnt;i++)
-
{
- QTextBlock textLine=doc->findBlockByNumber (i) ; // 文本中的一段
- QString str=textLine.text();
- ui->comboBox->addItem(icon,str);
- }
- }
QPlainTextEdit 的文字内容以 QTextDocument 类型存储,函数 document() 返回这个文档对象的指针。
QTextDocument 是内存中的文本对象,以文本块的方式存储,一个文本块就是一个段落,每个段落以回车符结束。QTextDocument 提供一些函数实现对文本内容的存取:
- int blockCount():获得文本块个数。
- QTextBlock fmdBlockByNumber(int blockNumber):读取某一个文本块,序号从 0 开始,至 blockCount()-1 结束。
一个 document 有多个 TextBlock,从 document 中读取出的一个文本块类型为 QTextBlock,通过
QTextBlock::text()
函数可以获取其纯文本文字。
使用 QPlainTextEdit 自带的快捷菜单
QPlainTextEdit 是一个多行文字编辑框,有自带的右键快捷菜单,可实现常见的编辑功能。在 UI 设计器里,选择为 plainTextEdit 的
customContextMenuRequested()
信号生成槽函数,编写如下的代码,就可以创建并显示 QPlainTextEdit 的标准快捷菜单:
纯文本复制
- void Widget::on_plainTextEdit_customContextMenuRequested(const QPoint &pos)
-
{
- //创建并显示标准弹出式菜单
- QMenu* menu=ui->plainTextEdit->createStandardContextMenu();
- menu->exec(pos);
- }