目录

1. 基本概念

2. 常用方法

添加部件到布局

添加布局到布局

设置行和列的最小尺寸

设置行和列的拉伸因子

3. 示例代码

4. 注意事项

5. QGridLayout 的典型用例

示例 1：表单布局

示例 2：计算器布局

6. 设计建议

7. 参考文档

---

        Qt 中的 QGridLayout 是一种非常常用的布局管理器，它将窗口部件排列在一个二维网格中。与其它布局管理器（如 QHBoxLayout 和 QVBoxLayout）不同，QGridLayout 允许你在行和列的网格中放置窗口部件，这使得它更加灵活，尤其在需要复杂布局时。

1. 基本概念

• 行（Row）和列（Column）: QGridLayout 将窗口部件放置在网格的单元格中，每个单元格由行和列的索引来定位。
• 行跨度和列跨度: 一个窗口部件可以跨越多个行或列。

2. 常用方法

以下是 QGridLayout 的一些常用方法：

添加部件到布局

void addWidget(QWidget *widget, int row, int column, Qt::Alignment alignment = Qt::Alignment());
void addWidget(QWidget *widget, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment());

• widget: 要添加的窗口部件。
• row 和 column: 窗口部件的位置。
• rowSpan 和 columnSpan: 窗口部件跨越的行数和列数。
• alignment: 对齐方式，例如 Qt::AlignLeft, Qt::AlignRight, Qt::AlignTop, Qt::AlignBottom 等。

添加布局到布局

void addLayout(QLayout *layout, int row, int column, Qt::Alignment alignment = Qt::Alignment());
void addLayout(QLayout *layout, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment());

• layout: 要添加的子布局。
• row 和 column: 子布局的位置。
• rowSpan 和 columnSpan: 子布局跨越的行数和列数。
• alignment: 对齐方式。

设置行和列的最小尺寸

void setRowMinimumHeight(int row, int minSize);
void setColumnMinimumWidth(int column, int minSize);

• row 和 column: 行和列的索引。
• minSize: 最小尺寸。

设置行和列的拉伸因子

void setRowStretch(int row, int stretch);
void setColumnStretch(int column, int stretch);

• row 和 column: 行和列的索引。
• stretch: 拉伸因子，值越大，该行或列在窗口调整大小时会优先拉伸。

3. 示例代码

以下是一个简单的示例，演示如何使用 QGridLayout 创建一个3x3的网格布局：

#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QGridLayout>

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

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

    for (int i = 0; i < 3; ++i) {
        for (int j = 0; j < 3; ++j) {
            QPushButton *button = new QPushButton(QString("Button %1,%2").arg(i).arg(j));
            layout->addWidget(button, i, j);
        }
    }

    window.setLayout(layout);
    window.show();

    return app.exec();
}

4. 注意事项

• QGridLayout 中的每个单元格只能包含一个窗口部件（或一个子布局）。如果需要在同一个单元格中放置多个窗口部件，可以使用一个容器窗口部件（如 QWidget）来包含它们。
• 当窗口大小调整时，QGridLayout 会根据设置的拉伸因子来调整行和列的大小。
• 可以使用 setSpacing() 方法设置布局中窗口部件之间的间距。

5. QGridLayout 的典型用例

示例 1：表单布局

QGridLayout 常用于创建表单布局，例如添加标签和输入框。如下所示：

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

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

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

    layout->addWidget(new QLabel("Name:"), 0, 0);
    layout->addWidget(new QLineEdit(), 0, 1);
    layout->addWidget(new QLabel("Email:"), 1, 0);
    layout->addWidget(new QLineEdit(), 1, 1);
    layout->addWidget(new QLabel("Phone:"), 2, 0);
    layout->addWidget(new QLineEdit(), 2, 1);
    layout->addWidget(new QPushButton("Submit"), 3, 0, 1, 2); // 跨越两列

    window.setLayout(layout);
    window.setWindowTitle("Form Example");
    window.show();

    return app.exec();
}

示例 2：计算器布局

用于创建计算器的按键布局，展示如何使用 QGridLayout 来组织多个按键：

#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QGridLayout>
#include <QLineEdit>

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

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

    QLineEdit *display = new QLineEdit();
    layout->addWidget(display, 0, 0, 1, 4); // 显示区域跨越四列

    QStringList buttons = {
        "7", "8", "9", "/",
        "4", "5", "6", "*",
        "1", "2", "3", "-",
        "0", "C", "=", "+"
    };

    int buttonIndex = 0;
    for (int row = 1; row <= 4; ++row) {
        for (int column = 0; column < 4; ++column) {
            layout->addWidget(new QPushButton(buttons[buttonIndex++]), row, column);
        }
    }

    window.setLayout(layout);
    window.setWindowTitle("Calculator");
    window.show();

    return app.exec();
}

6. 设计建议

• 尽量使用拉伸因子: 通过设置行和列的拉伸因子，您可以让布局在窗口调整大小时具有更好的适应性。
• 使用间距: 适当设置 setSpacing() 和 setContentsMargins()，以增强布局的可读性和美观性。
• 考虑动态调整: 如果您的界面需要动态添加或移除控件，QGridLayout 仍能很好地处理这些变化，不过要注意可能需要手动更新列和行的结构，确保均匀和一致。

7. 参考文档

• Qt 官方文档 Qt Documentation 以获取更详细的信息和示例。