PySide6中QWizard设置LogoPixmap不显示问题求助

问题核心原因 #

QWizard的Logo能否显示，直接取决于当前使用的向导样式（WizardStyle）。默认情况下，Windows AeroStyle、Mac MacStyle等现代样式会隐藏Logo区域，即便图片路径完全有效，也无法渲染出你设置的Pixmap。

解决方案 #

1. 切换至支持Logo的经典样式 #

显式设置QWizard使用ClassicStyle，该样式会保留Logo显示区域：

self.setWizardStyle(QWizard.ClassicStyle)

2. 简化图片加载逻辑 #

无需通过QImage中转加载图片，直接用QPixmap读取即可，避免潜在的格式兼容问题：

self.setPixmap(QWizard.LogoPixmap, QPixmap(img))

修改后的完整可运行代码 #

from PySide6.QtCore import Qt
from PySide6.QtWidgets import (QVBoxLayout, QApplication, QWizardPage, QWizard, QLabel)
from PySide6.QtGui import (QIcon, QPixmap, QImage)

class Page1(QWizardPage):

    def __init__(self, img, parent=None):
        super().__init__(parent)

        self.setTitle('General Properties')
        self.setSubTitle('Enter general properties for this project.')

        # 测试用图片（正常显示）
        layout = QVBoxLayout()
        graphics = QLabel(self)
        graphics.setPixmap(QPixmap(img))
        layout.addWidget(graphics)
        self.setLayout(layout)


class ProjectWizard(QWizard):
    def __init__(self, parent=None):
        super().__init__(parent)
        img = './Icon_256.png'

        self.addPage(Page1(img, self))
        self.setWindowTitle("New Project")
        
        # 设置支持Logo显示的经典样式
        self.setWizardStyle(QWizard.ClassicStyle)
        # 直接设置Logo图片
        self.setPixmap(QWizard.LogoPixmap, QPixmap(img))

if __name__ == "__main__":
    app = QApplication([])
    wizard = ProjectWizard()
    wizard.show()
    app.exec()

额外说明 #

• 若想保留现代样式同时显示Logo，需自定义QWizard布局，通过setLayout手动添加Logo控件，这需要更多UI定制工作。
• ClassicStyle对Logo尺寸建议为128x128左右，过大的图片会被自动缩放适配。

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