PyQt5如何将带QLabel的QVBoxLayout挂载到主窗口并正常显示
核心问题成因
- QMainWindow存在固定的内置界面结构,自带菜单栏、工具栏、状态栏、可停靠区域模块,本身不支持直接通过
setLayout()挂载自定义布局,直接调用会触发内部布局校验,导致所有挂到布局上的控件无法正常渲染 - 创建的QLabel在初始化时没有指定父级容器,按照Qt的控件规则,没有父对象的控件会被判定为独立顶层窗口,单独调用
show()时就会弹出游离的悬浮窗口,而非嵌入主窗口内部
修复实现方案
- 给QMainWindow设置一个通用QWidget作为内置中心承载容器,通过
setCentralWidget()方法挂载,这个容器是主窗口内唯一支持自由排布布局的可编辑区域 - 将QVBoxLayout直接挂载到这个中心承载容器上,替代原本直接给QMainWindow设置布局的错误逻辑
- 所有需要垂直排列的QLabel正常添加到该布局中,即可实现预设的垂直排布效果
修复后可运行完整代码
import sys from PyQt5.QtWidgets import ( QApplication, QMainWindow, QWidget, QVBoxLayout, QLabel ) from PyQt5.QtCore import Qt #Gui def CreateModule(label_text): label = QLabel(label_text) label.setAlignment(Qt.AlignCenter) label.setStyleSheet("background-color:purple") return label class MainWindow(QMainWindow): def __init__(self, *args, **kwargs): super(MainWindow, self).__init__(*args, **kwargs) self.setWindowTitle("My awesome App") self.showMaximized() self.setStyleSheet("background-color:black") # 初始化主窗口的中心承载容器 central_container = QWidget() self.setCentralWidget(central_container) # 将垂直布局绑定到中心容器上 self.main_layout = QVBoxLayout(central_container) app = QApplication(sys.argv) window = MainWindow() label1 = CreateModule('label1') label2 = CreateModule('label2') label3 = CreateModule('label3') window.main_layout.addWidget(label1) window.main_layout.addWidget(label2) window.main_layout.addWidget(label3) window.show() app.exec_()
易忽略的细节:直接给QMainWindow调用
setLayout()时,PyQt5不会抛出程序崩溃级别的报错,仅会在控制台输出非致命警告,新手很容易误以为代码逻辑生效,实际所有控件都不会被渲染到主窗口上。
内容的提问来源于stack exchange,提问作者user12810571
相关产品推荐
相关产品推荐

