C

GridLayout QML 类型

提供了一种在网格中动态排列项的方法。更多信息...

GridLayout 遵循 Qt Quick Layouts 中相同 QML 类型的行为。有关更详细的信息，请参阅 Qt Quick Layouts 概览。

如果调整 GridLayout 的大小，布局中的所有项都将重新排列。GridLayout 元素的可见子项属于该布局。如果您想有一个只有一行或一列的布局，可以使用 RowLayout 或 ColumnLayout。这些提供更方便的 API，并且提高了可读性。

默认情况下，项是按照 flow 属性排列的。默认值 flow 属性为 GridLayout.LeftToRight。

如果指定了 columns 属性，则它被视为布局在自动定位回下一行开始的之前能有的最大列数。

注意： 当 flow 为 GridLayout.LeftToRight 时，才使用 columns 属性。

rows 属性以类似的方式工作，但项将垂直自动定位。

注意： 当 flow 为 GridLayout.TopToBottom 时，才使用 rows 属性。

您可以通过设置Layout.row和Layout.column属性来指定项目想要占据的单元格。您还可以通过设置Layout.rowSpan或Layout.columnSpan属性来指定行范围或列范围。

GridLayout中的项目支持以下附加属性

另请参阅RowLayout和ColumnLayout。

[默认] columnSpacing : int

此属性包含每一列之间的间距。

columns : int

如果flow是GridLayout.LeftToRight，则此属性包含项目定位的列限制。默认值是没有限制。

此属性包含未设置显式单元格位置的项目流方向。它与columns或rows属性一起使用，分别指定当流重置到下一行或列时。

可能值

常量	说明
`GridLayout.LeftToRight`	项目依次排列，然后换行（默认）。
`GridLayout.TopToBottom`	项目从上到下依次排列，然后换到下一列。

另请参阅rows和columns。

layoutDirection : enumeration

此属性包含网格布局的布局方向 - 它控制项目是从左到右还是从右到左布局。如果指定了Qt.RightToLeft，则左对齐的项目将被右对齐，而右对齐的项目将被左对齐。

可能值

常量	说明
`Qt.LeftToRight`	项目从左到右排列（默认）。
`Qt.RightToLeft`	项目从右到左排列。

[默认] rowSpacing : int

此属性包含每一行之间的间距。

rows : int

如果flow是GridLayout.TopToBottom，则此属性包含定位项目的行限制。默认值是没有限制。

在某些Qt许可证下可用。
了解更多信息。