【PyQt】网格布局 QGridLayout

QGridLayout(parent)，在构建新网格布局时必须将其插入父布局。

你可以随时添加子控件或布局到此布局中，但在将其插入父布局之前，整个布局都不会执行。

QGridLayout 通过其父布局或 parentWidget() 获取可用空间，将其划分为行和列，并将其管理的每个窗口小部件放入正确的单元格中。

每列具有最小宽度和拉伸系数。最小宽度是使用 setColumnMinimumWidth() 设置的值与该列中所有控件的最小宽度之中的最大值。拉伸因子使用 setColumnStretch() 设置，并确定列将超过其必要最小值的可用空间量。

通常，使用 addWidget() 将每个托管控件或布局放入自己的单元格中。使用 addItem() 和addWidget() 的行和列跨越重载，窗口小部件也可能占用多个单元格。如果这做，QGridLayout将猜测如何在列/行上分配大小（基于拉伸因子）。

使用 removeWidget() 可以从布局中删除控件。或者在控件上使用 hide() 也可以有效地将其隐藏，直到使用 show()。

上图中第 0、2 和 4 列均由一个 QLabel、一个 QLineEdit 和一个 QListBox组成，第 1 列和第 3 列则是使用 setColumnMinimumWidth() 创建的占位符。第 0 行包含三个 QLabel 对象，第 1 行包括三个 QLineEdit 对象，第 2 行包括三个 QListBox 对象。

请注意，上图中列和行的宽高并不一定相同。如果希望两列具有相同的宽度，则必须自己将最小宽度和拉伸系数设置为相同。您可以使用 setColumnMinimumWidth() 和 setColumnStretch() 执行此操作。

如果 QGridLayout 不是顶级布局（即，不管理所有窗口小部件的区域和子窗口），则必须在在创建之后对其执行任何操作之前，将其添加到其父布局。添加布局的常规方法是在父布局上调用 addLayout()。

QGridLayout还包括两个边距宽度：contentsMargins 和 spacing()。contentsMargins 是 QGridLayout 四边的保留空间的宽度。spacing() 是相邻框之间自动分配的间距的宽度。

contentsMargins 默认值由 style 提供，子控件默认为 9，窗口为 11。spacing 默认与顶级布局的 margin 宽度相同，或与父布局的相同。

• QGridLayout.addItem(item, row, column[, rowSpan=1[, columnSpan=1[, alignment=Qt.Alignment()]]])
  指定行、列、跨行数、跨列数和对齐方式，将给定项目添加至布局中。
  如果 rowSpan 和/或 columnSpan 为 -1，则项目将分别延伸到底部和/或右边缘。不要使用此函数添加子布局或子控件项。请改用 addLayout() 或 addWidget()。

• QGridLayout.addLayout(arg__1, row, column[, alignment=Qt.Alignment()])
  指定行、列和对齐方式，将给定布局添加至此布局中。
  左上坐标从 (0,0) 起始。默认对齐方式为 0，这意味着子控件填充整个单元格。非零对齐表示布局不应增长以填充可用空间，但应根据 sizeHint() 进行调整。

• QGridLayout.addLayout(arg__1, row, column, rowSpan, columnSpan[, alignment=Qt.Alignment()])
  这是一个重载函数。指定行、列、跨行数、跨列数和对齐方式，将给定布局添加至布局中。如果 rowSpan 和/或 columnSpan 为 -1，则布局将分别延伸到底部和/或右边缘

• QGridLayout.addWidget(arg__1, row, column[, alignment=Qt.Alignment()])
  指定行、列和对齐方式，将给定控件添加至此布局中。

• QGridLayout.addWidget(arg__1, row, column, rowSpan, columnSpan[, alignment=Qt.Alignment()])
  这是一个重载函数。指定行、列、跨行数、跨列数和对齐方式，将给定控件添加至布局中。如果 rowSpan 和/或 columnSpan 为 -1，则控件将分别延伸到底部和/或右边缘

• QGridLayout.cellRect(row, column)