QT QTextEdit指定光标位置文本着色后内容不显示问题咨询

问题根因 #

• 逻辑错误：当前代码使用insertHtml是插入新内容而非修改原有内容格式，若display_text中已经包含待着色的coloring_string，会额外插入重复内容导致文本结构异常，出现内容截断/展示不全的问题。
• 光标位置误差：调用setText()后QTextEdit内部文档需要完成布局初始化才能获得准确的光标位置，立即操作光标会出现偏移甚至越界，触发渲染异常。
• 类名拼写错误：代码中QTextcursor拼写错误，正确类名为QTextCursor（首字母C大写），拼写错误可能导致不可预期的运行异常。

修复代码 #

场景1：给原有文本中指定位置的指定内容着色（无需插入新内容） #

该场景为绝大多数需求场景，直接修改原有文本的格式即可：

ui->textEdit->setText(display_text);
// 强制处理未完成的文档初始化事件，保证光标位置计算准确
QCoreApplication::processEvents();

QTextCursor cursor = ui->textEdit->textCursor();
// 移动到着色起始位置
cursor.setPosition(cursor_position);
// 选中待着色的完整内容，长度为着色字符串的长度
cursor.movePosition(QTextCursor::Right, QTextCursor::KeepAnchor, coloring_string.length());

// 设置红色字符格式
QTextCharFormat format;
format.setForeground(Qt::red);
cursor.mergeCharFormat(format);

// 将着色区域滚动到可视区域，避免超出视口看不到
ui->textEdit->setTextCursor(cursor);
ui->textEdit->ensureCursorVisible();

场景2：需要在指定位置插入新的着色文本 #

若display_text中不包含待着色内容，确实需要插入新内容时，增加位置合法性校验即可：

ui->textEdit->setText(display_text);
QCoreApplication::processEvents();

QTextCursor cursor = ui->textEdit->textCursor();
// 校验光标位置合法性，避免越界
int totalLength = ui->textEdit->document()->characterCount();
cursor_position = qMin(cursor_position, totalLength);
cursor.setPosition(cursor_position);

// 插入着色内容，注意html属性加引号保证兼容性
cursor.insertHtml("<span style=\"color:red;\">"+coloring_string+"</span>");

ui->textEdit->setTextCursor(cursor);
ui->textEdit->ensureCursorVisible();

注意事项 #

• 若display_text本身为富文本，不要用纯文本的字符数计算cursor_position，富文本的标签会占用字符计数导致位置偏移，建议通过QTextDocument::find()接口查找目标文本的准确位置。
• 多次点击按钮触发着色时，不要重复调用setText()重置整个文本，否则会丢失之前的着色格式，建议仅在第一次初始化时调用setText()，后续直接操作光标修改格式即可。

内容的提问来源于stack exchange，提问作者drophie