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

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

访客 技术 2026年5月25日 4

在使用 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...

发表评论

访客

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