QTextEdit 总结

关于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[];
    sprintf(strCol, "#%06x", RamdomNum);
    col.setNamedColor(QString::fromLocal8Bit(strCol, ));
    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 = ; 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 == )
        return;

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

}

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

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