如何捕获包含控件和标题栏的QMainWindow窗口快照？

你尝试用两种方法捕获QMainWindow快照，但分别只能得到控件区域或标题栏，无法同时获取完整窗口。以下是问题原因和解决方法：

问题原因 #

• QWidget.grab()：仅能捕获控件自身的绘制区域，标题栏属于系统窗口装饰，不在QMainWindow的内部绘制范围内，因此偏移坐标也无法捕获到标题栏。
• screen.grabWindow(w.winId(), ...)：这里的winId()对应的是QMainWindow的客户区（内部控件区域），而非包含标题栏的整个系统窗口，因此偏移y坐标后只能抓到标题栏区域，无法覆盖客户区。

解决方法 #

直接获取窗口在屏幕上的全局完整几何区域（包含标题栏、边框），然后捕获该区域的屏幕内容即可。

修改后的完整代码 #

from PySide6.QtWidgets import QApplication, QMainWindow, QPushButton

application = QApplication()

button = QPushButton("Hello, world!")
w = QMainWindow()
w.setCentralWidget(button)
w.show()

# 确保窗口完成渲染
application.processEvents()

# 获取包含标题栏的完整窗口区域
full_window_rect = w.frameGeometry()
# 捕获完整窗口快照
w.screen().grabRectangle(full_window_rect).save("full_window.png")

# 兼容旧版本Qt的写法（效果一致）
# w.screen().grabWindow(0, full_window_rect.x(), full_window_rect.y(), 
#                       full_window_rect.width(), full_window_rect.height()).save("full_window.png")

application.exec()

关键说明 #

1. frameGeometry()：返回窗口在屏幕上的完整几何信息，包含标题栏、边框等系统装饰部分，而非仅客户区。
2. application.processEvents()：替代sleep()，让应用处理所有待处理事件，确保窗口完全渲染后再截图，避免出现空白或不完整的快照。
3. grabRectangle()：Qt 5.15及以上版本支持的方法，直接传入QRect即可捕获对应屏幕区域；旧版本可使用grabWindow(0, ...)，其中0表示捕获整个屏幕，再指定窗口的全局坐标和尺寸。

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