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)