QTextDocument::drawContents未渲染图片问题求助

看起来你遇到的核心问题是QTextDocument在调用drawContents时，无法正确识别你添加的内部图片资源——虽然QTextEdit能正常渲染，但直接调用drawContents时，资源查找逻辑有细微差异，导致它尝试从本地文件加载（而非使用你添加的缩放后图片），最终显示文件图标。以下是具体的排查和解决方法：

1. 用自定义Scheme的URL作为资源键 #

你当前使用文件名（如QUrl(url.fileName())）作为资源标识，这会让QTextDocument在drawContents时优先尝试从本地文件系统加载该文件，如果找不到对应路径的文件，就会显示默认的文件图标。

解决方法是使用带自定义Scheme的唯一URL作为资源键（比如image://custom/xxx），这样QTextDocument会直接查找内部资源，不会去本地文件系统尝试加载：

QImage image(url.toLocalFile());
if (image.isNull()) return;
image = image.scaledToHeight(getDocumentHeight(), Qt::SmoothTransformation);

// 生成唯一的自定义资源URL（用时间戳保证唯一性，避免冲突）
QUrl resourceUrl(QString("image://custom/%1").arg(QDateTime::currentMSecsSinceEpoch()));

// 将缩放后的图片添加到文档资源
textEdit->document()->addResource(QTextDocument::ImageResource, resourceUrl, image);
// 插入图片到文本
textEdit->textCursor().insertImage(resourceUrl);

2. 直接禁用文档自动换行（无需依赖临时QTextEdit） #

你当前通过创建临时QTextEdit并设置NoWrap来实现无换行布局，但这可能导致文档布局未及时更新，或者依赖QTextEdit的上下文。更可靠的方式是直接给QTextDocument设置超大的文本宽度，强制其不换行：

// 替代临时QTextEdit的方式，直接让文档不自动换行
document->setTextWidth(QWIDGETSIZE_MAX); // QWIDGETSIZE_MAX是Qt定义的超大值，确保文本横向无折行

// 创建匹配文档尺寸的渲染图片
QImage renderImage(document->size().width(), document->size().height(), QImage::Format_ARGB32_Premultiplied);
renderImage.fill(Qt::transparent);

QPainter painter(&renderImage);
// 添加渲染优化，提升图片显示质量
painter.setRenderHint(QPainter::Antialiasing);
painter.setRenderHint(QPainter::SmoothPixmapTransform);

// 绘制文档内容到图片
document->drawContents(&painter);

3. 验证资源是否正确添加 #

在渲染之前，可以先检查文档中的资源是否存在，排除资源未正确添加的情况：

// 替换成你实际使用的资源URL
QUrl resourceUrl(...);
QVariant resource = document->resource(QTextDocument::ImageResource, resourceUrl);
if (resource.canConvert<QImage>()) {
    qDebug() << "资源存在，尺寸：" << resource.value<QImage>().size();
} else {
    qDebug() << "资源未正确添加！";
}

为什么这样有效？ #

• 自定义Scheme的URL避免了QTextDocument混淆内部资源和本地文件，确保drawContents时直接使用你添加的缩放后图片。
• 直接设置文档的setTextWidth比依赖临时QTextEdit更直接，避免了布局上下文的问题，确保文档尺寸准确匹配无折行的内容。

按照以上步骤修改后，你应该能在渲染的QImage中看到正确的图片，而非文件图标。

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