桌面应用 / 系统课时

用网格布局制作表单界面

用网格布局制作表单界面

本节解决表单类界面控件排列的问题,学习使用 QGridLayout 按行列组织标签和输入框,构建结构稳定、易维护的桌面应用表单页面。

学习目标

  • 理解 QGridLayout 的行列布局模型。
  • 掌握标签和输入控件组合成表单的实现方式。
  • 能够设计适应窗口变化的基础表单界面。

表单界面的布局需求

桌面应用中经常需要创建登录页、配置页、信息编辑页等表单界面。这类界面通常具有明显的二维结构:左侧是字段名称,右侧是输入区域。

如果使用固定坐标,需要手动计算每个控件的位置;字段增加后,维护成本会快速提高。QGridLayout 使用行和列描述控件关系,可以根据内容自动调整布局。

QGridLayout表单行列结构示意图

使用 QGridLayout 创建表单

下面示例创建一个简单用户信息表单,将标签和输入框放入对应的行列位置。

cpp
#include <QApplication>
#include <QGridLayout>
#include <QLabel>
#include <QLineEdit>
#include <QWidget>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QWidget window;
    auto *layout = new QGridLayout(&window);

    auto *nameLabel = new QLabel("姓名");
    auto *nameEdit = new QLineEdit;
    auto *emailLabel = new QLabel("邮箱");
    auto *emailEdit = new QLineEdit;

    // 参数顺序为 行、列,控件位置由网格决定
    layout->addWidget(nameLabel, 0, 0);
    layout->addWidget(nameEdit, 0, 1);
    layout->addWidget(emailLabel, 1, 0);
    layout->addWidget(emailEdit, 1, 1);

    window.show();
    return app.exec();
}

预期结果

text
窗口显示两行表单内容:
姓名    输入框
邮箱    输入框

调整列宽和控件扩展

默认情况下,网格会根据控件尺寸分配空间。实际项目中,经常需要让输入框占据更多空间,而标签保持较小宽度。

可以通过列伸缩因子调整空间分配:

cpp
layout->setColumnStretch(1, 1);

预期结果

text
第二列具有更高伸缩优先级,窗口扩大时输入区域获得更多空间。

QGridLayout 的常见使用方式

QGridLayout 适合具有明确行列关系的界面,例如:

场景 布局方式
用户注册页面 标签列 + 输入列
配置参数页面 参数名称 + 参数值
数据编辑窗口 字段标题 + 编辑控件

如果界面主要是线性排列,例如按钮栏或简单垂直列表,QHBoxLayout 和 QVBoxLayout 通常更直接。

设计表单时的注意点

表单布局需要关注可维护性。不要为了调整一个控件的位置而增加大量空白控件,也不要依赖固定坐标控制间距。优先使用布局提供的间距、伸缩和对齐能力,让界面结构随着需求变化自然扩展。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用网格布局制作表单界面

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通