如何在PyQt5的QMainWindow类中嵌入表格

嘿，我完全懂你现在的困扰——本来想把表格嵌在带按钮的主窗口里，结果跑出两个独立窗口，确实有点头疼😅。其实这是PyQt新手很容易踩的小坑，核心问题就是你把表格控件当成了独立窗口来初始化，而不是作为主窗口的子部件来处理。下面我给你一步步拆解解决方案，再附上完整的示例代码：

关键问题点 #

你之前的表格类（QWidget）应该是单独调用了show()或者没有设置父部件，导致它被当成了独立的顶层窗口。我们需要做的就是：

• 让表格成为主窗口的子部件，通过父部件参数绑定从属关系
• 利用QMainWindow的中心部件机制，把按钮和表格统一放到主窗口的布局里

完整示例代码 #

1. 表格控件类（QWidget） #

首先调整你的表格类，初始化时接收父部件参数，并且不要单独调用show()：

from PyQt5.QtWidgets import QWidget, QTableWidget, QTableWidgetItem, QVBoxLayout

class TableWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)  # 传入父部件，绑定从属关系
        
        # 创建表格并填充示例数据
        self.table = QTableWidget(5, 3)
        for row in range(5):
            for col in range(3):
                self.table.setItem(row, col, QTableWidgetItem(f"单元格 ({row}, {col})"))
        
        # 给当前QWidget设置布局，把表格放进去
        layout = QVBoxLayout()
        layout.addWidget(self.table)
        self.setLayout(layout)

2. 主窗口类（QMainWindow） #

主窗口需要先创建一个中心部件（QMainWindow不能直接设置布局，必须通过这个中心部件），然后把按钮和表格都加到中心部件的布局里：

from PyQt5.QtWidgets import QMainWindow, QWidget, QPushButton, QVBoxLayout, QApplication
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("嵌入表格的主窗口")
        self.setGeometry(100, 100, 800, 600)  # 设置窗口位置和大小
        
        # 创建中心部件，作为主窗口的内容容器
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        
        # 创建垂直布局，把按钮和表格都放进去
        main_layout = QVBoxLayout(central_widget)
        
        # 添加按钮到布局
        self.action_btn = QPushButton("这是主窗口的按钮")
        main_layout.addWidget(self.action_btn)
        
        # 实例化表格控件，把中心部件作为父部件
        self.table_widget = TableWidget(parent=central_widget)
        main_layout.addWidget(self.table_widget)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    main_window = MainWindow()
    main_window.show()  # 只需要显示主窗口，表格作为子部件会自动跟着显示
    sys.exit(app.exec_())

核心注意事项 #

• 不要在表格类中调用self.show()，也不要给表格单独创建QApplication实例，这些操作会让它变成独立窗口
• 一定要给表格控件传入父部件参数，这样PyQt才会知道它是某个窗口的子控件，而不是顶层窗口
• QMainWindow的布局必须通过setCentralWidget()来设置，直接给QMainWindow加布局是无效的

这样修改之后，表格就会乖乖嵌在主窗口里，和按钮一起显示啦！

内容的提问来源于stack exchange，提问作者The Cedar Prince