Python GUI开发：PyQt5网格布局QGridLayout详解与实战

Luna

发布时间：2026-10-13| 2人浏览过

原创

本文详细介绍PyQt5中的QGridLayout网格布局控件，涵盖addWidget方法的单格与跨格用法。通过计算器界面和故障申告表单两个完整代码示例，演示如何创建网格实例、添加控件及设置行列跨越，帮助开发者掌握窗口界面布局的核心技巧。

PyQt5布局控件QGridLayout简介

QGridLayout（网格布局）通过将窗口划分为行和列的网格来进行排列。通常可以使用函数addWidget（）将被管理的控件（Widget）添加到窗口中，或者使用addLayout（）函数将布局（layout）添加到窗口中，也可以通过addWIdget（）函数对所添加的控件设置行数与列数的跨越，最后实现网格占据多个窗格

QGridLayout类中常用的方法

方法	描述
addWidget(QWidget Widget,int row,int col,int alignment=0)	给网格布局添加部件，设置指定的行和列，起始位置的默认值为（0,0）
	widget：所添加的控件
	row：控件的行数，默认从0开始
	column：控件的列数，默认从0开始
	alignment：对齐方式
addWidget(QWidget widget,int fromRow,int fromColulmn,int rowSpan,int columnSpan,Qt.Alignment alignment=0)	所添加的的控件跨越很多行或者列的时候，使用这个函数
	widget：所添加的控件
	fromRow：控件的起始行数
	fronColumn：控件的起始列数
	rowSpan：控件跨越的行数
	column：控件跨越的列数
	alignment：对齐方式
setSpacing(int spacing)	设置软件在水平和垂直方向的间隔

QGridLayout单一的网格单元格实例


import sys
from PyQt5.QtWidgets import QApplication ,QWidget , QGridLayout, QPushButton
class Winform(QWidget):
  def __init__(self,parent=None):
    super(Winform,self).__init__(parent)
    self.initUI()
  def initUI(self):      
    #1创建QGridLayout的实例，并设置窗口的布局
    grid = QGridLayout() 
    self.setLayout(grid) 
    #2创建按钮的标签列表
    names = ['Cls', 'Back', '', 'Close', 
         '7', '8', '9', '/', 
        '4', '5', '6', '*', 
         '1', '2', '3', '-', 
        '0', '.', '=', '+'] 
    #3 在网格中创建一个位置列表    
    positions = [(i,j) for i in range(5) for j in range(4)] 
    #4 创建按钮并通过addWIdget（）方法添加到布局中
    for position, name in zip(positions, names):        
      if name == '': 
        continue 
      button = QPushButton(name) 
      grid.addWidget(button, *position) 
    self.move(300, 150) 
    self.setWindowTitle('网格布局管理例子') 
if __name__ == "__main__": 
    app = QApplication(sys.argv) 
    form = Winform()
    form.show()
    sys.exit(app.exec_())

运行效果图如下

第一组代码：创建QGridLayout的实例，并设置窗口的布局

第二组代码：创建按钮的标签列表

第三组代码：在网格中创建一个位置列表

第四组代码：创建按钮并通过addWIdget（）方法添加到布局中

QGridLayout跨越行和列的网格单元格实例


import sys
from PyQt5.QtWidgets import (QWidget, QLabel, QLineEdit,  QTextEdit, QGridLayout, QApplication) 
class Winform(QWidget):
  def __init__(self,parent=None):
    super(Winform,self).__init__(parent)
    self.initUI()
  def initUI(self):      
    titleLabel = QLabel('标题') 
    authorLabel = QLabel('提交人') 
    contentLabel = QLabel('申告内容') 
    titleEdit = QLineEdit() 
    authorEdit = QLineEdit() 
    contentEdit = QTextEdit() 
    grid = QGridLayout() 
    grid.setSpacing(10) 
    grid.addWidget(titleLabel, 1, 0) 
    grid.addWidget(titleEdit, 1, 1) 
    grid.addWidget(authorLabel, 2, 0) 
    grid.addWidget(authorEdit, 2, 1) 
    grid.addWidget(contentLabel, 3, 0) 
    grid.addWidget(contentEdit, 3, 1, 5, 1) 
    self.setLayout(grid)  
    self.setGeometry(300, 300, 350, 300) 
    self.setWindowTitle('故障申告')
if __name__ == "__main__": 
    app = QApplication(sys.argv) 
    form = Winform()
    form.show()
    sys.exit(app.exec_())

运行效果示意图如下