窗口调整宽度后标题栏捕获异常，如何确保快照前标题栏已更新？

我认为这和「如何捕获包含控件和标题栏的窗口？」问题相关，但需要不同的解决方案。

调整窗口大小后，捕获标题栏时得到了不符合预期的结果。

from PySide6.QtCore import QTimer
from PySide6.QtWidgets import QApplication, QMainWindow

application = QApplication()
window = QMainWindow()
window.show()
screen = window.screen()


def save_titlebar(filename: str) -> None:
    window.screen().grabWindow(
        window.winId(),
        x=window.frameGeometry().x() - window.geometry().x(),
        y=window.frameGeometry().y() - window.geometry().y(),
        w=window.frameGeometry().width(),
        h=window.frameGeometry().height() - window.geometry().height(),
    ).save(filename)


def set_width_and_save(width: int) -> None:
    window.setFixedWidth(width)
    QTimer.singleShot(500, lambda: save_titlebar(f"titlebar{width}.png"))


QTimer.singleShot(1000, lambda: set_width_and_save(400))
QTimer.singleShot(2000, lambda: set_width_and_save(500))
QTimer.singleShot(3000, lambda: set_width_and_save(300))
QTimer.singleShot(4000, window.close)
application.exec()

titlebar400.png:

titlebar500.png:

titlebar300.png:

如何确保在快照前标题栏已完成更新？

方法一：强制处理待处理事件 #

不要依赖固定延迟的QTimer，设置窗口宽度后直接调用QApplication.processEvents()，强制处理所有布局、重绘事件，确保窗口状态稳定后再截图：

def set_width_and_save(width: int) -> None:
    window.setFixedWidth(width)
    # 处理所有待处理的GUI事件，确保标题栏更新完成
    QApplication.processEvents()
    save_titlebar(f"titlebar{width}.png")

方法二：监听窗口resize事件 #

自定义QMainWindow子类，在窗口完成大小调整的resizeEvent触发后执行截图，精准捕获标题栏更新完成的时机：

from PySide6.QtCore import QTimer
from PySide6.QtWidgets import QApplication, QMainWindow

class MyMainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.resize_finished_callback = None

    def resizeEvent(self, event):
        super().resizeEvent(event)
        # 窗口resize完成后触发回调
        if self.resize_finished_callback:
            # 用0延迟定时器确保事件循环处理完所有重绘操作
            QTimer.singleShot(0, self.resize_finished_callback)
            self.resize_finished_callback = None

application = QApplication()
window = MyMainWindow()
window.show()

def save_titlebar(filename: str) -> None:
    window.screen().grabWindow(
        window.winId(),
        x=window.frameGeometry().x() - window.geometry().x(),
        y=window.frameGeometry().y() - window.geometry().y(),
        w=window.frameGeometry().width(),
        h=window.frameGeometry().height() - window.geometry().height(),
    ).save(filename)

def set_width_and_save(width: int) -> None:
    window.resize_finished_callback = lambda: save_titlebar(f"titlebar{width}.png")
    window.setFixedWidth(width)

QTimer.singleShot(1000, lambda: set_width_and_save(400))
QTimer.singleShot(2000, lambda: set_width_and_save(500))
QTimer.singleShot(3000, lambda: set_width_and_save(300))
QTimer.singleShot(4000, window.close)
application.exec()

关键说明 #

• 固定延迟的QTimer不可靠，不同系统、窗口管理器处理窗口重绘的时间差异大，延迟设置不合理会导致截图失败。
• QApplication.processEvents()会立即处理所有待处理的GUI事件，包括布局调整和标题栏重绘，确保截图时窗口状态已更新完成。
• 监听resizeEvent是更精准的方案，只有当窗口实际完成大小调整后才触发截图，完全避免了延迟带来的问题。

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