如何将带标题栏的QDialog渲染为QImage？

你遇到的问题根源在于：QDialog的render()和grab()方法仅抓取窗口的客户区（标题栏以下的内容），而标题栏是由操作系统窗口管理器负责绘制的，不属于Qt控件自身的绘制范围，所以直接调用这两个方法无法捕获标题栏。

要完整渲染包含标题栏的QDialog，有两种可行方案：

方案一：使用QScreen的grabWindow方法（推荐） #

这个方法可以直接抓取操作系统绘制的整个窗口，包括标题栏，是最简便的解决方案。需要确保对话框已经被显示（窗口管理器已完成标题栏绘制），代码示例如下：

// 先确保对话框已显示（若之前未显示）
_dialog->show();

// 获取当前屏幕对象
QScreen* screen = QGuiApplication::primaryScreen();
// 抓取整个窗口（传入窗口句柄winId()）
QImage img = screen->grabWindow(_dialog->winId()).toImage();

// 保存图片
img.save("xxx.png");

// 若不需要对话框继续显示，可隐藏
_dialog->hide();

注意：如果是模态对话框，需在对话框显示后执行抓取操作；非模态对话框可在show()后立即执行。

方案二：自定义标题栏（适合定制样式场景） #

如果需要完全自定义标题栏样式，或无法依赖系统窗口句柄，可以把标题栏作为QDialog客户区的一部分实现：

• 禁用QDialog的原生标题栏：setWindowFlags(Qt::FramelessWindowHint)
• 在QDialog内部添加自定义标题栏控件（如QLabel显示标题、QPushButton实现关闭/最小化按钮）
• 实现标题栏的拖动、窗口控制逻辑
• 此时调用render()或grab()就能捕获包含自定义标题栏的完整窗口

这种方案需要额外开发标题栏交互逻辑，适合对窗口样式有特殊需求的场景，否则优先选择方案一。

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