PyQt中如何在菜单栏下方显示图片（避免被遮挡）

我懂你遇到的这个困扰——菜单栏占了QDialog顶部的空间，但你在paintEvent里直接用self.rect()把图片铺满整个窗口，结果顶部的图片就被菜单栏挡住了。其实核心问题就是你说的，rect()包含了整个窗口的区域，包括菜单栏占用的部分，咱们只需要调整绘制的目标区域就能解决。

解决方案思路 #

Qt提供了contentsRect()方法，它会返回窗口的客户区域——也就是排除了菜单栏、工具栏等装饰元素之后剩下的可用空间。用这个区域来绘制图片，就能完美避开菜单栏的遮挡。另外，初始化窗口大小时也要考虑菜单栏的高度，避免图片被窗口边界裁切。

修改后的完整代码 #

import sys
from PyQt5 import QtGui
from PyQt5.QtGui import QPixmap
from PyQt5.QtWidgets import QMainWindow, QApplication, QPushButton, QDialog, QMenuBar, QAction, QHBoxLayout

class Example(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        self.button = QPushButton()
        self.button.setText("Click")
        self.button.setMaximumHeight(100)
        self.button.setMaximumWidth(100)
        self.button.clicked.connect(self.clicked)
        self.layout().addWidget(self.button)
        self.show()

    def clicked(self):
        self.something = SecondExample()
        self.something.exec()

class SecondExample(QDialog):
    def __init__(self):
        super().__init__()
        layout = QHBoxLayout()
        toolbar = QMenuBar()
        toolbar.addAction(QAction("Edit", toolbar))
        toolbar.addAction(QAction("Polygon", toolbar))
        toolbar.addAction(QAction("Rectangle", toolbar))
        layout.setMenuBar(toolbar)
        self.setLayout(layout)
        
        self.pixmap = QPixmap(r"C:\Users\kjankosk\Desktop\Panasonic-OLED-TV-FZ950-Lifestyle.jpg")
        # 计算窗口总大小：图片尺寸 + 菜单栏高度
        menu_bar_height = toolbar.sizeHint().height()
        self.resize(self.pixmap.width(), self.pixmap.height() + menu_bar_height)

    def paintEvent(self, event):
        super().paintEvent(event)
        painter = QtGui.QPainter(self)
        painter.setRenderHint(QtGui.QPainter.Antialiasing, True)
        # 使用contentsRect()获取菜单栏下方的可用区域
        painter.drawPixmap(self.contentsRect(), self.pixmap)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

关键修改点 #

1. 绘制区域调整：把paintEvent里的self.rect()换成self.contentsRect()，确保图片只绘制在菜单栏下方的客户区域，不会被遮挡。
2. 窗口大小适配：初始化时获取菜单栏的高度，加到图片高度上，让窗口能完整容纳菜单栏和图片，避免图片被窗口底部裁切。

额外优化（可选） #

如果你希望图片能自适应客户区域的大小（保持比例不变），可以用scaled方法对图片进行缩放：

painter.drawPixmap(
    self.contentsRect(), 
    self.pixmap.scaled(
        self.contentsRect().size(), 
        Qt.KeepAspectRatio, 
        Qt.SmoothTransformation
    )
)

这样图片会自动调整大小，刚好填满客户区域，同时不会变形。

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