QTextEdit 总结 - 一 水

QTe xtEdit 总结 - 一 水 

关于Qt的富文本处理, 可以参考文档: Rich Text Processing

该文档有人翻译了一下(本来我想翻译- -!), 参考Rich Text Processing富文本处理 

QTextEdit的组成比较复杂, 最好看看文档了解一下Rich Text Document Structure

1. HTML形式操纵Qtextedit

　　QTextEdit支持HTML的一个子集, 所以对于简单的使用, 可以直接插入HTML代码

　　

editor->append("<img src=\"mydata://image.png\" />");

　　通过插入html代码, 可以实现图片, 字体, 字号, 颜色等功能
　ps: QTextEdit中img标签仅支持src, width, height三个属性, 使用其他属性会自动被Qt过滤掉, 即editor->toHtml()中无法找到

　　可以通过正则来过滤toHtml()生成的代码

　　其他HTML支持, 参考Supported HTML Subset

2. 在QTextEdit中播放gif

　　QTextEdit虽然直接img标签, 但默认不播放gif, 也不会显示gif的第一帧 (如果你不需要编辑功能的话, 其实可以用QWebView来查看)

　　所以在QTextEdit中播放gif需要手动换帧. 

　　QMovie内置了gif解析和定时器功能. 

　　QTextDocument 使用addResource 把图片资源加载进来, 然后通过QMovie->start启动定时器, 不断更新图片资源

QString g_fileName = ":/test.gif";
QUrl g_url("TestImageTag");

void MyClass::InsertImage()
{
QMovie* movie = new QMovie(this);
movie->setFileName(g_fileName);
movie->setCacheMode(QMovie::CacheNone);

//换帧时刷新
connect(movie, SIGNAL(frameChanged(int)), this, SLOT(OnAnimate(int)));
movie->start();
}

g_url 是自定义的标签, 用来标记QTextDocument 中的resource

void MyClass::OnAnimate(int a)
{
if (QMovie* movie = qobject_cast<QMovie*>(sender()))
{
document()->addResource(QTextDocument::ImageResource, //替换图片为当前帧
g_url, movie->currentPixmap());

setLineWrapColumnOrWidth(lineWrapColumnOrWidth()); // 刷新显示
}
}

addResource 指定ImageResource, 然后根据url, 若url已存在, 则更新资源, 若url不存在, 则添加资源

这样就实现刷新gif的帧. 这样, QTextEdit就会显示gif动画了

 

最后是添加gif图片:

可以插入HTML: 

editor->append("<img src=\"TestImageTag\" />");

即img中指定为我们自定义的url即可

也可以使用QTextCursor插入:

QTextCursor cursor = editor->textCursor();
QTextImageFormat imageFormat;
imageFormat.setName("TestImageTag");
cursor.insertImage(imageFormat);

PS: 可以使用两个数组来保存自定义的URL和QMOVIE, 以便管理资源释放等问题

PS2: 在我的测试中, 即使调用了Qtextedit和QTextDocument的clear也无法释放addResource图片资源的内存.  只有把QTextEdit整个delete掉, 才会释放所有图片资源占据的内存.  这是个问题, 可能需要看源码来解决. 不过如果图片不多的话, 这个问题也可以忽略

 

3. 如何遍历QTextEdit中的内容

　　QTextEdit中的内容实际上是由QTextDocument维护

　　可以简单的理解: QTextDocument 包含 N个QTexBlock(段落), 每个QTexBlock包含N个QTextFragment

　　

QColor _GetRamdomColor()
{
QColor col;
int RamdomNum = rand() % 0xffffff;
char strCol[8];
sprintf(strCol, "#%06x", RamdomNum);
col.setNamedColor(QString::fromLocal8Bit(strCol, 8));
return col;
}


void MyClass::OnTest()
{
QTextDocument *document = ui.textEdit->document();
QTextBlock &currentBlock = document->begin();
QTextBlock::iterator it;
QTextCursor cursor = ui.textEdit->textCursor();

while( true)
{
// 在修改chatformat时会改变当前Block的fragment
// 所以++it的处理类似std::map中的erase操作
for (it = currentBlock.begin(); !(it.atEnd()); )
{
QTextFragment currentFragment = it.fragment();
QTextImageFormat newImageFormat = currentFragment.charFormat().toImageFormat();

if (newImageFormat.isValid()) {
// 判断出这个fragment为image
++it;
continue;
}


if (currentFragment.isValid())
{
++it;
int pos = currentFragment.position();
QString strText = currentFragment.text();
for(int i = 0; i < strText.length(); i++)
{
// 选择一个字, 随机设定颜色
QTextCharFormat fmt;
fmt.setForeground(_GetRamdomColor());
QTextCursor helper = cursor;
helper.setPosition(pos++);
helper.setPosition(pos, QTextCursor::KeepAnchor);
helper.setCharFormat(fmt);
}
}

}

currentBlock = currentBlock.next();
if(!currentBlock.isValid())
break;
}
// 光标移动到最后, 并设置拥有焦点
QTextCursor c = ui.textEdit->textCursor();
c.movePosition(QTextCursor::End, QTextCursor::MoveAnchor);
ui.textEdit->setTextCursor(c);
ui.textEdit->setFocus(Qt::MouseFocusReason);
}

这段代码用于渲染QTextEdit为炫彩, 每个字随机分配一种颜色

遍历的时候, 判断是图片还是文字. 并作相应的处理

同时, 处理下QTextDocument的contentChange事件, 即可在键盘输入时, 就改变字的颜色

connect(document, SIGNAL(contentsChange( int , int , int )),
this, SLOT(OnContentChange( int , int , int )));

void MyClass::OnContentChange( int position, int charsRemoved, int charsAdded )
{
if(charsAdded == 0)
return;

QTextCursor cursor = ui.textEdit->textCursor();
for (int i = 0; i < charsAdded; i++ )
{
int pos = position + i;
// 选择一个字, 随机设定颜色
QTextCharFormat fmt;
fmt.setForeground(_GetRamdomColor());
QTextCursor helper = cursor;
helper.setPosition(pos);
helper.setPosition(pos+1, QTextCursor::KeepAnchor);
helper.setCharFormat(fmt);
}

}

PS: 对某段文字执行setCharFormat也会触发contentChange信号, 并且charsRemoved == charsAdded; 可以处理一下这个case

　　这样一般来说满足了大部分需求, 做出类似QQ的聊天输入框只需要再处理下复制黏贴图片之类就行了. 至于Qt的rich edit中frame table list等, 需要的话, 就看看文档吧, 感觉功能不是很必要