【QT开发】表单布局QFormLayout类详解及实战应用

I'mAlex

已于 2024-07-14 13:37:24 修改

阅读量1.1k

点赞数 28

分类专栏： QT开发教程文章标签： qt 开发语言

于 2024-07-14 13:37:06 首次发布

本文链接：https://blog.csdn.net/g310773517/article/details/140329658

版权

QT开发教程专栏收录该内容

418 篇文章 86 订阅

订阅专栏

QFormLayout是Qt提供的一个功能强大且灵活的表单布局管理类，通过本篇文章的学习，你应该对QFormLayout有了全面的理解，能够在自己的项目中正确使用它。QFormLayout在用户界面中帮助你更好地管理和排列表单控件，实现高效的表单布局，有助于创建用户友好和高效的应用场景。

🧑 博主简介：现任阿里巴巴嵌入式技术专家，15年工作经验，深耕嵌入式+人工智能领域，精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者，提供产品测评、学习辅导、简历面试辅导、毕设辅导、项目开发、C/C++/Java/Python/Linux/AI等方面的服务，如有需要请站内私信或者联系任意文章底部的的VX名片（ID：gylzbk）

💬 博主粉丝群介绍：① 群内初中生、高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

在这里插入图片描述

【QT开发】表单布局QFormLayout类详解及实战应用

- 🌟概述
- 📖 QFormLayout类介绍
- - 常用方法
  - 常用的枚举类型
- 💻示例代码
- - 示例：基本表单布局
  - - 头文件：mainwindow.h
    - 源文件：mainwindow.cpp
  - 代码解释
  - 方法分析
  - 枚举分析
- 🧐注意事项
- 🛠️使用技巧
- 📌总结

🌟概述

QFormLayout是Qt框架中的一个类，用于在表单中排列控件。表单布局通常用于需要对控件进行标签和输入字段配对的场景，如登录界面、用户信息表单等。QFormLayout提供了一种简洁且灵活的方式来管理这些控件，使得创建和管理表单变得非常方便。

QFormLayout在需要快速创建和管理表单的场景中非常常见，如设置界面、用户注册、数据输入等。

📖 QFormLayout类介绍

在Qt官方文档中，QFormLayout类的定义如下：

class QFormLayout : public QLayout
{
    Q_OBJECT
    // ...
}

QFormLayout继承自QLayout，是一个用于管理表单中控件排列的类。以下是一些关键特性和功能：

标签与字段对齐：能够将标签和输入字段进行配对排列，并且支持标签右对齐、左对齐和顶部对齐等对齐方式。
行管理：支持添加、插入和移除行，包括标签和字段控件。
布局控制：提供方法来控制表单布局的行间距和控件对齐等属性。

常用方法

以下是QFormLayout类中一些常用的方法及其简要介绍：

构造函数和析构函数：
- QFormLayout(QWidget *parent = nullptr)：构造函数，创建一个QFormLayout对象。
- ~QFormLayout()：析构函数，销毁QFormLayout对象。
行管理：
- void addRow(QWidget *label, QWidget *field)：添加标签和字段控件到表单的末尾。
- void addRow(const QString &labelText, QWidget *field)：添加标签文本和字段控件到表单的末尾。
- void insertRow(int row, QWidget *label, QWidget *field)：在指定行插入标签和字段控件。
- void insertRow(int row, const QString &labelText, QWidget *field)：在指定行插入标签文本和字段控件。
- void removeRow(int row)：移除指定行。
对齐控制：
- void setLabelAlignment(Qt::Alignment alignment)：设置标签的对齐方式。
- void setFormAlignment(Qt::Alignment alignment)：设置表单的对齐方式。
- void setFieldGrowthPolicy(FieldGrowthPolicy policy)：设置字段的增长策略。
- void setRowWrapPolicy(RowWrapPolicy policy)：设置行的自动换行策略。
布局查询：
- QWidget *labelForField(QWidget *field) const：返回与指定字段控件配对的标签控件。
- QWidget *itemAt(int row, ItemRole role) const：返回指定行中的标签或字段控件。
- int rowCount() const：返回表单中的行数。

常用的枚举类型

以下是QFormLayout类中一些常用的枚举类型及其简要介绍：

FieldGrowthPolicy：字段增长策略。
- ExpandingFieldsGrow：字段控件随着表单布局的增长而增长。
- AllNonFixedFieldsGrow：所有非固定大小的字段控件随着表单布局的增长而增长。
- FieldsStayAtSizeHint：字段控件保持其默认建议大小。
RowWrapPolicy：行的自动换行策略。
- DontWrapRows：不自动换行。
- WrapAllRows：每行自动换行。
- WrapLongRows：长行自动换行。

💻示例代码

下面是一个简单的示例，用来演示如何使用QFormLayout创建一个基本的表单。该示例展示了一个带有表单布局的窗口，包括用户输入的标签和字段控件。

示例：基本表单布局

头文件：mainwindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QFormLayout>
#include <QLineEdit>
#include <QTextEdit>
#include <QPushButton>

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
};

#endif // MAINWINDOW_H

源文件：mainwindow.cpp

#include "mainwindow.h"

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    setWindowTitle("QFormLayout Example");
    resize(400, 300);

    // 创建UI组件
    QLineEdit *nameLineEdit = new QLineEdit();
    QLineEdit *emailLineEdit = new QLineEdit();
    QTextEdit *addressTextEdit = new QTextEdit();
    QPushButton *submitButton = new QPushButton("Submit");

    // 创建表单布局
    QFormLayout *formLayout = new QFormLayout();
    formLayout->addRow("Name:", nameLineEdit);
    formLayout->addRow("Email:", emailLineEdit);
    formLayout->addRow("Address:", addressTextEdit);
    formLayout->addRow(submitButton);

    // 创建中央控件并设置布局
    QWidget *centralWidget = new QWidget(this);
    centralWidget->setLayout(formLayout);

    setCentralWidget(centralWidget);
}

MainWindow::~MainWindow() = default;

代码解释

创建主窗口，并设置其标题和大小：

MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    setWindowTitle("QFormLayout Example");
    resize(400, 300);
}

创建UI组件，包括标签和输入字段：

QLineEdit *nameLineEdit = new QLineEdit();
QLineEdit *emailLineEdit = new QLineEdit();
QTextEdit *addressTextEdit = new QTextEdit();
QPushButton *submitButton = new QPushButton("Submit");

创建QFormLayout对象，并添加标签和输入字段：

QFormLayout *formLayout = new QFormLayout();
formLayout->addRow("Name:", nameLineEdit);
formLayout->addRow("Email:", emailLineEdit);
formLayout->addRow("Address:", addressTextEdit);
formLayout->addRow(submitButton);

创建中央控件，并设置表单布局为其布局：

QWidget *centralWidget = new QWidget(this);
centralWidget->setLayout(formLayout);

设置中央控件为主窗口的中央控件：
```
setCentralWidget(centralWidget);
```

方法分析

void addRow(QWidget *label, QWidget *field)：添加标签和字段控件到表单的末尾。
```
void addRow(QWidget *label, QWidget *field)
```
用于将标签和字段控件作为一行添加到表单的末尾。
void addRow(const QString &labelText, QWidget *field)：添加标签文本和字段控件到表单的末尾。
```
void addRow(const QString &labelText, QWidget *field)
```
用于将标签文本和字段控件作为一行添加到表单的末尾。
void insertRow(int row, QWidget *label, QWidget *field)：在指定行插入标签和字段控件。
```
void insertRow(int row, QWidget *label, QWidget *field)
```
用于在指定行插入标签和字段控件。
void insertRow(int row, const QString &labelText, QWidget *field)：在指定行插入标签文本和字段控件。
```
void insertRow(int row, const QString &labelText, QWidget *field)
```
用于在指定行插入标签文本和字段控件。
void removeRow(int row)：移除指定行。
```
void removeRow(int row)
```
用于移除表单中的指定行。
void setLabelAlignment(Qt::Alignment alignment)：设置标签的对齐方式。
```
void setLabelAlignment(Qt::Alignment alignment)
```
用于设置标签的对齐方式。
void setFormAlignment(Qt::Alignment alignment)：设置表单的对齐方式。
```
void setFormAlignment(Qt::Alignment alignment)
```
用于设置表单的对齐方式。
void setFieldGrowthPolicy(FieldGrowthPolicy policy)：设置字段的增长策略。
```
void setFieldGrowthPolicy(FieldGrowthPolicy policy)
```
用于设置字段的增长策略。
void setRowWrapPolicy(RowWrapPolicy policy)：设置行的自动换行策略。
```
void setRowWrapPolicy(RowWrapPolicy policy)
```
用于设置行的自动换行策略。
QWidget *labelForField(QWidget *field) const：返回与指定字段控件配对的标签控件。
```
QWidget* labelForField(QWidget *field) const
```

用于获取与指定字段控件配对的标签控件。

QWidget *itemAt(int row, ItemRole role) const：返回指定行中的标签或字段控件。
```
QWidget* itemAt(int row, ItemRole role) const
```

用于获取指定行中的标签或字段控件，ItemRole 可为 LabelRole 或 FieldRole。

int rowCount() const：返回表单中的行数。
```
int rowCount() const
```

用于获取表单中的行数。

枚举分析

FieldGrowthPolicy：字段增长策略。
- ExpandingFieldsGrow：字段控件随着表单布局的增长而增长。
- AllNonFixedFieldsGrow：所有非固定大小的字段控件随着表单布局的增长而增长。
- FieldsStayAtSizeHint：字段控件保持其默认建议大小。
RowWrapPolicy：行的自动换行策略。
- DontWrapRows：不自动换行。
- WrapAllRows：每行自动换行。
- WrapLongRows：长行自动换行。

🧐注意事项

布局排列：QFormLayout适用于标签和字段成对排列的场景，对于复杂布局可能需要结合其他布局管理器使用。
控件对齐：合理设置标签和字段的对齐方式，确保表单美观和用户友好。
动态修改：在动态修改表单布局时，注意更新和刷新布局，确保新的控件正确显示。

🛠️使用技巧

动态添加和移除行：通过动态添加和移除行，可以实现动态表单布局。

QFormLayout *formLayout = new QFormLayout();
QLineEdit *dynamicField = new QLineEdit();
formLayout->addRow("Dynamic Field:", dynamicField);

formLayout->removeRow(dynamicField);

设置对齐方式：通过设置标签和字段的对齐方式，可以控制表单的美观和排版。
```
formLayout->setLabelAlignment(Qt::AlignRight);
formLayout->setFormAlignment(Qt::AlignCenter);
```
字段增长策略：通过设置字段的增长策略，可以控制表单的自适应性。
```
formLayout->setFieldGrowthPolicy(QFormLayout::ExpandingFieldsGrow);
```
行换行策略：通过设置行的换行策略，可以控制表单的布局方式。
```
formLayout->setRowWrapPolicy(QFormLayout::WrapLongRows);
```

自定义控件：通过添加自定义控件，可以实现更加灵活和复杂的表单布局。

class CustomWidget : public QWidget
{
    Q_OBJECT

public:
    CustomWidget(QWidget *parent = nullptr) : QWidget(parent) {
        // 自定义控件实现
    }
};

CustomWidget *customWidget = new CustomWidget();
formLayout->addRow("Custom Widget:", customWidget);

📌总结

I'mAlex

关注

28
点赞
踩
21

收藏

觉得还不错? 一键收藏
打赏
0
评论
【QT开发】表单布局QFormLayout类详解及实战应用

QFormLayout是Qt提供的一个功能强大且灵活的表单布局管理类，通过本篇文章的学习，你应该对QFormLayout有了全面的理解，能够在自己的项目中正确使用它。QFormLayout在用户界面中帮助你更好地管理和排列表单控件，实现高效的表单布局，有助于创建用户友好和高效的应用场景。
复制链接

扫一扫