PySide6 QGridLayout 网格布局:跨行跨列、控件对齐策略

QGridLayout 是网格布局,以行、列二维表格形式摆放控件,区别于单行 / 单列的 Box 布局,适合表单、仪表盘、计算器、多模块面板这类规整的二维界面。
核心方法
QGridLayout 核心方法是 addWidget,用于将控件添加到指定的行、列位置,其函数签名如下:
| |
- w / arg__1:要放入的控件
- row:起始行号(从 0 开始)
- col:起始列号(从 0 开始)
- rowspan:占用多少行,默认 1
- colspan:占用多少列,默认 1
- alignment:控件在网格单元格内的对齐方式
| |
演示效果如下:

常用方法
尺寸与间距
setSpacing:设置所有控件之间横向 + 纵向统一间距setHorizontalSpacing:单独设置列间距(水平间距)setVerticalSpacing:单独设置行间距(垂直间距)spacing:获取统一间距值horizontalSpacing:获取水平间距verticalSpacing:获取垂直间距
| |
演示效果如下:

行列拉伸权重(非常关键)
setRowStretch:设置指定行的拉伸系数,数值越大窗口放大时该行分得更多空间setColumnStretch:设置指定列的拉伸系数,数值越大窗口放大时该列分得更多空间rowStretch:获取行拉伸系数columnStretch:获取列拉伸系数
| |
演示效果如下:

边界边距
setContentsMargins:设置布局整体内边距,布局和父控件边框之间的留白contentsMargins:获取当前边距
| |
演示效果如下:

查询类
rowCount:返回布局实际占用行数columnCount:返回布局实际占用列数getItemPosition:根据索引获取控件所在的 row, col, rowspan, colspanitemAtPosition:获取指定行列位置上的布局项(QLayoutItem)itemAt:按索引获取布局项count:布局内总项数量takeAt:移除指定索引的布局项并返回
| |
演示效果如下:

小结
QGridLayout 是一个二维网格布局,用于将控件组织在网格中。
按索引位置设置控件位置,并提供一系列的方法进行间隔、边距、查询等操作。