当前位置:首页 > 技术 > 正文内容

PyQt5 中 QMainWindow 与 QWidget 布局显示差异解析

访客 技术 2026年5月25日 44

在使用 PyQt5 构建图形界面时,继承 QMainWindow 和继承 QWidget 在控件布局显示上存在显著差异。核心区别在于 QMainWindow 默认不直接支持设置顶层布局,必须通过中央部件(Central Widget)来承载内容。

当基于 QMainWindow 创建窗口时,需先调用 setCentralWidget() 指定一个容器控件,再将布局或子控件添加至该容器中,否则控件不会被正确渲染。

from PyQt5.QtWidgets import QMainWindow, QApplication, QWidget
from PyQt5.QtGui import QGridLayout, QLineEdit

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setup_ui()

    def setup_ui(self):
        self.setWindowTitle("RFID 工具")
        self.resize(500, 346)

        # 必须创建并设置中央部件
        central_widget = QWidget()
        self.setCentralWidget(central_widget)

        # 定义网格布局并添加控件
        layout = QGridLayout()
        input_field1 = QLineEdit()
        input_field2 = QLineEdit()
        layout.addWidget(input_field1, 0, 0)
        layout.addWidget(input_field2, 0, 1)

        # 将布局绑定到中央部件
        central_widget.setLayout(layout)

相比之下,若继承自 QWidget,可直接通过 setLayout() 将布局应用到窗口本身,无需额外的中间容器:

from PyQt5.QtWidgets import QWidget, QApplication, QLineEdit
from PyQt5.QtGui import QGridLayout

class MainWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.setup_ui()

    def setup_ui(self):
        self.setWindowTitle("RFID 工具")
        self.resize(500, 346)

        layout = QGridLayout()
        field_a = QLineEdit()
        field_b = QLineEdit()
        layout.addWidget(field_a, 0, 0)
        layout.addWidget(field_b, 0, 1)

        self.setLayout(layout)  # 直接设置根布局

使用 Qt Designer 设计界面文件时,也应遵循相同原则:将生成的 UI 类实例化为 QWidget 并通过 setCentralWidget() 注入主窗口。

from PyQt5.QtWidgets import QMainWindow, QWidget
from ui.main_ui import Ui_MainWindow

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.central_area = QWidget()
        self.setCentralWidget(self.central_area)
        self.setupUi(self.central_area)

此外,若使用独立的 UI 文件(如 main.ui),可在初始化时将 setupUi() 作用于中央区域,确保布局正确加载。

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.central_widget = QWidget()
        self.setCentralWidget(self.central_widget)
        self.setupUi(self.central_widget)

总结:在 QMainWindow 中显示控件的关键是明确指定一个中央组件作为内容载体。而 QWidget 可直接作为布局宿主。理解这一机制有助于避免布局失效问题。

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。