PyQt5中QMainWindow与QWidget的用法差异及布局适配问题

Hey there, let's break down why your layout is misbehaving when switching from QWidget to QMainWindow, and how to fix it properly.

• QWidget is a generic base class for all UI elements. When used as a top-level window, you can directly apply a layout to it without any restrictions.
• QMainWindow is a specialized window built for standard application workflows—it has a predefined internal structure including a menu bar, toolbars, status bar, dock widgets, and a central widget. This structure means you can't set a layout directly on the QMainWindow itself; all custom UI elements need to fit within its existing framework.

When you converted the QWidget example to QMainWindow, you probably tried to attach the stacked widget or its layout directly to the main window. But QMainWindow ignores any layout set on itself because it uses its own internal layout to manage its standard components. That's exactly why your UI ended up looking messed up.

The correct approach is to work with QMainWindow's central widget system. Here's the step-by-step fix:

1. Create your QStackedWidget (plus any extra UI elements like page-switch buttons).
2. Wrap these elements in a container widget with your desired layout (if you need to arrange multiple components together).
3. Set this container (or the stacked widget alone, if it's your only central element) as the QMainWindow's central widget using setCentralWidget().

Here's a corrected implementation that uses QMainWindow with QStackedWidget properly:

import sys
from PyQt5.QtWidgets import (QApplication, QMainWindow, QStackedWidget, 
                             QWidget, QVBoxLayout, QPushButton, QLabel)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("QMainWindow + QStackedWidget")
        
        # Initialize the stacked widget and its pages
        self.stacked_widget = QStackedWidget()
        
        # Page 1
        page1 = QWidget()
        layout1 = QVBoxLayout(page1)
        layout1.addWidget(QLabel("Welcome to Page 1!"))
        self.stacked_widget.addWidget(page1)
        
        # Page 2
        page2 = QWidget()
        layout2 = QVBoxLayout(page2)
        layout2.addWidget(QLabel("This is Page 2, nice to see you!"))
        self.stacked_widget.addWidget(page2)
        
        # Create a container to hold buttons and the stacked widget
        container = QWidget()
        main_layout = QVBoxLayout(container)
        
        # Add page-switch buttons
        btn_page1 = QPushButton("Go to Page 1")
        btn_page1.clicked.connect(lambda: self.stacked_widget.setCurrentIndex(0))
        btn_page2 = QPushButton("Go to Page 2")
        btn_page2.clicked.connect(lambda: self.stacked_widget.setCurrentIndex(1))
        
        main_layout.addWidget(btn_page1)
        main_layout.addWidget(btn_page2)
        main_layout.addWidget(self.stacked_widget)
        
        # Set the container as the main window's central widget
        self.setCentralWidget(container)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

If you don't need any extra buttons or elements around your stacked widget, you can skip the container and directly set the QStackedWidget as the central widget with self.setCentralWidget(self.stacked_widget)—it works perfectly fine on its own.

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