PyQt5网格布局教程：QGridLayout使用指南 | Python GUI编程

PyQt5网格布局(QGridLayout)教程

创建灵活强大的Python GUI界面

什么是QGridLayout？

QGridLayout是PyQt5中用于创建基于网格的布局管理器。它允许你将小部件排列在二维网格中，类似于HTML表格或Excel电子表格。

与QVBoxLayout和QHBoxLayout相比，QGridLayout提供了更大的灵活性，特别适合需要复杂布局的界面设计。

(0,0)

行0, 列0

(0,1)

行0, 列1

(1,0)

行1, 列0

(1,1)

行1, 列1

基本网格布局示例

下面的代码展示了如何创建一个简单的2x2网格布局：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QGridLayout, QPushButton

class GridLayoutExample(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('PyQt5网格布局示例')
        self.setGeometry(300, 300, 300, 200)
        
        # 创建网格布局
        grid = QGridLayout()
        self.setLayout(grid)
        
        # 创建按钮并添加到网格
        positions = [(i, j) for i in range(2) for j in range(2)]
        for position in positions:
            button = QPushButton(f'按钮{position[0]}{position[1]}')
            grid.addWidget(button, *position)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = GridLayoutExample()
    window.show()
    sys.exit(app.exec_())

PyQt5网格布局教程：QGridLayout使用指南 | Python GUI编程 PyQt5 网格布局 QGridLayout 界面设计 2025 第1张

高级网格布局技巧

1. 跨越多行/列

使用rowSpan和columnSpan参数可以让小部件跨越多个网格单元：

# 创建一个3x3网格
grid = QGridLayout()

# 添加跨越两列的按钮
button_wide = QPushButton('跨越两列')
grid.addWidget(button_wide, 0, 0, 1, 2)  # 行0, 列0, 占用1行2列

# 添加跨越两行的按钮
button_tall = QPushButton('跨越两行')
grid.addWidget(button_tall, 1, 2, 2, 1)  # 行1, 列2, 占用2行1列

# 添加普通按钮
grid.addWidget(QPushButton('(1,0)'), 1, 0)
grid.addWidget(QPushButton('(1,1)'), 1, 1)
grid.addWidget(QPushButton('(2,0)'), 2, 0)
grid.addWidget(QPushButton('(2,1)'), 2, 1)

2. 控制对齐方式

使用alignment参数控制小部件在网格单元中的对齐方式：

from PyQt5.QtCore import Qt

# 顶部对齐
grid.addWidget(QPushButton('顶部'), 0, 0, alignment=Qt.AlignTop)

# 底部对齐
grid.addWidget(QPushButton('底部'), 1, 0, alignment=Qt.AlignBottom)

# 居中对齐
grid.addWidget(QPushButton('居中'), 0, 1, alignment=Qt.AlignCenter)

# 右侧对齐
grid.addWidget(QPushButton('右侧'), 1, 1, alignment=Qt.AlignRight)

3. 设置间距

使用setSpacing()控制网格间距：

grid = QGridLayout()

# 设置水平和垂直间距
grid.setHorizontalSpacing(20)  # 水平间距20像素
grid.setVerticalSpacing(10)    # 垂直间距10像素

完整示例：用户注册表单

下面是一个使用QGridLayout创建的用户注册表单完整示例：

import sys
from PyQt5.QtWidgets import (QApplication, QWidget, QGridLayout, QLabel, 
                             QLineEdit, QPushButton, QComboBox, QCheckBox)

class RegistrationForm(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('用户注册表单')
        self.setGeometry(300, 300, 400, 300)
        
        # 创建网格布局
        grid = QGridLayout()
        grid.setVerticalSpacing(15)
        grid.setHorizontalSpacing(10)
        self.setLayout(grid)
        
        # 添加表单元素
        labels = ['用户名:', '密码:', '确认密码:', '电子邮箱:', '国家/地区:', '订阅通知:']
        for i, text in enumerate(labels):
            grid.addWidget(QLabel(text), i, 0)
        
        # 添加输入框
        self.username = QLineEdit()
        self.password = QLineEdit()
        self.password.setEchoMode(QLineEdit.Password)
        self.confirm_password = QLineEdit()
        self.confirm_password.setEchoMode(QLineEdit.Password)
        self.email = QLineEdit()
        
        grid.addWidget(self.username, 0, 1, 1, 2)
        grid.addWidget(self.password, 1, 1, 1, 2)
        grid.addWidget(self.confirm_password, 2, 1, 1, 2)
        grid.addWidget(self.email, 3, 1, 1, 2)
        
        # 添加国家选择
        self.country = QComboBox()
        self.country.addItems(['中国', '美国', '英国', '日本', '德国', '其他'])
        grid.addWidget(self.country, 4, 1, 1, 2)
        
        # 添加复选框
        self.newsletter = QCheckBox('接收新闻和促销')
        grid.addWidget(self.newsletter, 5, 1)
        
        # 添加按钮
        self.register_btn = QPushButton('注册')
        self.cancel_btn = QPushButton('取消')
        grid.addWidget(self.register_btn, 6, 1)
        grid.addWidget(self.cancel_btn, 6, 2)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    form = RegistrationForm()
    form.show()
    sys.exit(app.exec_())