Qt Grid Layout行列创建分布机制及代码效果疑问

初始行列状态 #

你创建的QGridLayout初始时rowCount()和columnCount()返回1，这是Qt布局的默认行为：新创建的网格布局会默认预留一个1×1的空单元格作为初始占位，此时布局内无任何控件，行列数仅为基础占位值，示意图如下：

+-------+
| (0,0) |
+-------+

addWidget参数的核心逻辑 #

addWidget的完整参数定义为：

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

关键参数含义：

• row/column：控件放置的起始行/列索引（从0开始计数）
• rowSpan/columnSpan：控件跨越的行/列数，需注意：
  • 当值为0时，控件自动扩展到布局的最底部行/最右侧列，而非跨越0行/列
  • 当值为1时，控件仅占据当前起始行/列的单个单元格

你的代码布局逻辑分析 #

你对rowSpan和columnSpan的使用存在误区，导致布局异常：

1. 添加b1：addWidget(b1, 0, 0, 0, 0)
   此时布局为1×1，rowSpan=0和columnSpan=0意味着b1占据从(0,0)到布局边缘的所有区域，即整个1×1单元格。
2. 添加b2：addWidget(b2, 0, 0, 0, 1)
   起始行/列仍为(0,0)，rowSpan=0仅覆盖当前布局最后一行（行0），columnSpan=1仅占据1列，导致b2与b1完全重叠在(0,0)单元格，最终仅能看到后添加的b2。
3. 添加b3：addWidget(b3, 1, 0, 0, 0)
   起始行指定为1，超过当前布局的行索引最大值（0），布局自动扩展为2行。rowSpan=0覆盖从行1到布局底部（行1），columnSpan=0覆盖从列0到布局右侧（列0），即占据(1,0)单元格。
4. 添加b4：addWidget(b4, 1, 0, 0, 1)
   起始行/列为(1,0)，rowSpan=0覆盖行1，columnSpan=1覆盖列0，导致b4与b3重叠在(1,0)单元格，最终仅能看到后添加的b4。

最终实际窗口效果 #

运行代码后，窗口会显示两行，每行1个按钮：第一行是B2，第二行是B4，B1和B3被完全覆盖。

正确的两行两列布局写法 #

如果目标是实现两行两列的网格布局（每个按钮占一个单元格），应将rowSpan和columnSpan设为1，并指定正确的起始列：

layout->addWidget(b1, 0, 0, 1, 1); // 第0行第0列，跨1行1列
layout->addWidget(b2, 0, 1, 1, 1); // 第0行第1列，跨1行1列
layout->addWidget(b3, 1, 0, 1, 1); // 第1行第0列，跨1行1列
layout->addWidget(b4, 1, 1, 1, 1); // 第1行第1列，跨1行1列

此时布局自动扩展为2行2列，效果示意图：

+-------+-------+
|  B1   |  B2   |
+-------+-------+
|  B3   |  B4   |
+-------+-------+

内容的提问来源于stack exchange，提问作者Cesar