Qt富文本编辑器QTextDocument

版权声明：若无来源注明， Techie亮博客文章均为原创。 转载请以连接形式标明本文标题和地址：
本文标题：Qt富文本编辑器QTextDocument     本文地址： https://www.techieliang.com/2017/12/726/

文章目录

• 1. 介绍
• 2. 基本使用
•  2.1. 简单范例
•  2.2. QTextCursor光标操做/遍历嵌套Frame/遍历全部Block

1. 介绍

对于文本编辑，qt提供了不少控件

• QLineEdit：单行文本输入，好比用户名密码等简单的较短的或者具备单一特征的字符串内容输入。使用text、settext读写
• QTextEdit：富文本编辑器，支持html显示，能够用sethtml/tohtml进行html文本操做或使用，也可利用setPlainText、toPlainText进行纯文本操做
• QPlainTextEdit：纯文本编辑器，使用了近似于textedit的技术并作了纯文本编辑的优化，并具备文章段落的概念也提供了撤销等功能，但不支持html显示。
• QTextBrowser：继承于QTextEdit，仅提供显示功能，并提供了超文本导航功能，若是不须要超文本链接只须要使用QTextEdit并设置QTextEdit::setReadOnly

上述都是显示控件，能够肯定的是富文本编辑器要用QTextEdit或者QPlainTextEdit，可是确定不能主动撰写html代码或者逐个处理显示格式实现富文本，实际上Qt提供了相关类：QTextDocument富文本文档、QTextBlock文本快、QTextFrame框架、QTextTable表格、QTextList列表、QTextCursor指针位置、QTextXXXXFormat各类数据类型样式。对于富文本的全部帮助请见官方文档：Rich Text Processing

QTextEdit和QPlainTextEdit选择：差别是QTextEdit提供了tohtml，若是想在处理完文档，直接根据文档生成html做为博客等内容，能够使用此类，没有须要后者便可

注意关系：QTextDocument>QTextFrame>QTextBlock/QTextTable/QTextList前包含后

查看两个类的api，均提供了document方法，能够返回QTextDocument指针，用于经过QTextDocument的方式操做文档内容格式，官方范例：

Application Example这个比较简单

Syntax Highlighter Example语法高亮的例子

Text Edit Example相似于word编辑器的例子

Calendar Example利用富文本编辑器的方式实现日历(不建议学这个毕竟已经有现成的日历控件，并且文档中每每也不会插入日历)

Order Form Example根据一些的参数设置生成报表，其实和上面的原理同样

2. 基本使用

首先当具备一个edit时，不须要自行建立document，能够直接用document方法能够获取当前edit的document

QTextDocument只是一个文档，其内还有根节点，须要使用QTextDocument::rootFlrame获取，设置根节点的边框粗细、颜色就相似于设置word文档边框底纹

2.1. 简单范例

1. #include "mainwindow.h"
2. #include "ui_mainwindow.h"
3. #include <QTextDocument>
4. #include <QTextFrame>
5. #include <QTextBlock>
6. MainWindow::MainWindow(QWidget *parent) :
7. QMainWindow(parent),
8. ui(new Ui::MainWindow) {
9. ui->setupUi(this);
10. QTextDocument* doc = ui->textEdit->document();
11. QTextFrame *root_frame = doc->rootFrame();
12. QTextFrameFormat root_frame_format = root_frame->frameFormat();//建立框架格式
13. root_frame_format.setBorderBrush(Qt::darkBlue);//设置边界颜色
14. root_frame_format.setBorder(5);//设置边界宽度
15. root_frame->setFrameFormat(root_frame_format); //给框架使用格式
16. QTextFrameFormat frame_format;
17. frame_format.setBackground(Qt::darkRed);//设置背景色
18. frame_format.setMargin(10);//设置边距
19. frame_format.setPadding(5);//设置填充
20. frame_format.setBorder(2);//设置边界宽度
21. frame_format.setBorderStyle(
22. QTextFrameFormat::BorderStyle_Solid);//设置边框样式
23. frame_format.setPosition(QTextFrameFormat::FloatRight);//右侧
24. frame_format.setWidth(QTextLength(
25. QTextLength::PercentageLength, 40));//宽度设置
26. QTextCursor cursor = ui->textEdit->textCursor();
27. cursor.insertText("A company");
28. cursor.insertBlock();
29. cursor.insertText("321 City Street");
30. cursor.insertBlock();
31. cursor.insertFrame(frame_format);
32. cursor.insertText("Industry Park");
33. cursor.insertBlock();
34. cursor.insertText("Another country");
35. }

上述代码仅显示了四行文字，前两行在root跟框架显示，后两行在一个新建的frame中显示，并将frame置于右侧限定了宽度，更多的布局方法请参考：Order Form Example

上述并未对文本格式作设置，能够在insertText的第二个参数直接赋予一个文本格式QTextCharFormat

2.2. QTextCursor光标操做/遍历嵌套Frame/遍历全部Block

首先他有各类instert函数能够插入上面提到的各类文档中的数据类型。有时并不能一次准确的创建好整个文档，须要在中间插入，这样就须要setPosition命令，而positon的具体值能够经过上述各类数据类型的类获取到每一个块或者框架或者其余类型开头的positon，也能够经过length获取到当前块的长度用于定位末尾位置。下面提供一个简单范例

1. #include "mainwindow.h"
2. #include "ui_mainwindow.h"
3. #include <QTextDocument>
4. #include <QTextFrame>
5. #include <QTextBlock>
6. #include <QDebug>
7. MainWindow::MainWindow(QWidget *parent) :
8. QMainWindow(parent),
9. ui(new Ui::MainWindow) {
10. ui->setupUi(this);
11. QTextDocument* doc = ui->textEdit->document();
12. QTextFrame *root_frame = doc->rootFrame();
13. QTextFrameFormat root_frame_format = root_frame->frameFormat();//建立框架格式
14. root_frame_format.setBorderBrush(Qt::darkBlue);//设置边界颜色
15. root_frame_format.setBorder(5);//设置边界宽度
16. root_frame->setFrameFormat(root_frame_format); //给框架使用格式
17. QTextFrameFormat frame_format;
18. frame_format.setBackground(Qt::darkRed);//设置背景色
19. frame_format.setMargin(10);//设置边距
20. frame_format.setPadding(5);//设置填充
21. frame_format.setBorder(2);//设置边界宽度
22. frame_format.setBorderStyle(
23. QTextFrameFormat::BorderStyle_Solid);//设置边框样式
24. frame_format.setPosition(QTextFrameFormat::FloatRight);//右侧
25. frame_format.setWidth(QTextLength(
26. QTextLength::PercentageLength, 40));//宽度设置
27. QTextCursor cursor = ui->textEdit->textCursor();
28. cursor.insertText("A company");
29. cursor.insertBlock();
30. cursor.insertText("321 City Street");
31. cursor.insertFrame(frame_format);
32. cursor.insertText("Industry Park");
33. cursor.insertBlock();
34. cursor.insertText("Another country");
35. //遍历frame
36. for(auto block = root_frame->begin();!block.atEnd();++block) {
37. if(block.currentBlock().isValid()) {
38. qDebug()<<block.currentBlock().text();
39. }
40. else if(block.currentFrame()) {//frame嵌套，范例只有两层因此不递归了
41. auto child_frame = block.currentFrame();
42. for(auto block2 = child_frame->begin();!block2.atEnd();++block2) {
43. if(block.currentBlock().isValid()) {
44. qDebug()<<block2.currentBlock().text();
45. }
46. }
47. }
48. }
49. //还能够经过root_frame->childFrames()直接获取所字frame
50. //遍历文本块
51. QTextBlock block = doc->firstBlock();
52. for(int i = 0; i < doc->blockCount();i++) {
53. qDebug() << QString("block num:%1\tblock first line number:%2\tblock length:%3\ttext:")
54. .arg(i).arg(block.firstLineNumber()).arg(block.length())
55. << block.text();
56. block = block.next();
57. }
58. QTextBlock insert_block = doc->firstBlock().next();
59. //在第二行末尾添加
60. cursor.setPosition(insert_block.position()+insert_block.length()-1);
61. cursor.insertText("change cursor postion and insert");
62. //在第三行开头添加-也就是新frame里面最开始添加
63. //方法一，第二行末尾+1就是第三行开头
64. cursor.setPosition(insert_block.position()+insert_block.length());
65. //方法二，position默认返回的就是一个块开头
66. cursor.setPosition(insert_block.next().position());
67. //方法三,利用frame，frame是在一个锚点定位，开头在第二行末尾因此必须加一
68. cursor.setPosition(frame_format.position()+1);
69. cursor.insertText("change cursor postion and insert");
70. }

前面的内容没有变化，后面先展现了如何遍历全部frame以及嵌套的frame。若是是全文检索或者总体修改也能够直接遍历全文全部block

 

转载请以连接形式标明本文标题和地址： Techie亮博客 » Qt富文本编辑器QTextDocument