GridLayout QML 类型

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

• 所有成员的列表，包括继承的成员

属性

• columnSpacing : real
• columns : int
• flow : 枚举
• layoutDirection : 枚举 (自 QtQuick.Layouts 1.1)
• rowSpacing : real
• rows : int
• uniformCellHeights : bool (自 QtQuick.Layouts 6.6)
• uniformCellWidths : bool (自 QtQuick.Layouts 6.6)

详细描述

为了更有效地使用此类型，建议您了解 Qt Quick Layouts 模块的一般机制。有关更多信息，请参阅Qt Quick Layouts 概述。

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

默认情况下，项将根据flow属性排列。flow属性的默认值是GridLayout.LeftToRight。

如果指定了columns属性，它将被视为布局可以有的列数的最大限制，在自动定位回下一行的开始之前。只有当flow是GridLayout.LeftToRight时，才会使用columns属性。

GridLayout {
    id: grid
    columns: 3

    Text { text: "Three"; font.bold: true; }
    Text { text: "words"; color: "red" }
    Text { text: "in"; font.underline: true }
    Text { text: "a"; font.pixelSize: 20 }
    Text { text: "row"; font.strikeout: true }
}

rows属性以类似的方式工作，但项是按垂直自动定位。只有当flow是GridLayout.TopToBottom时，才会使用rows属性。

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

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

• Layout.row
• Layout.column
• Layout.rowSpan
• Layout.columnSpan
• Layout.minimumWidth
• Layout.minimumHeight
• Layout.preferredWidth
• Layout.preferredHeight
• Layout.maximumWidth
• Layout.maximumHeight
• Layout.fillWidth
• Layout.fillHeight
• Layout.alignment
• Layout.margins
• Layout.leftMargin
• Layout.rightMargin
• Layout.topMargin
• Layout.bottomMargin
• Layout.horizontalStretchFactor
• Layout.verticalStretchFactor

有关附加属性的更多信息，请参考此处。

另请参阅：RowLayout，ColumnLayout，StackLayout，Grid，以及Qt Quick 框架概览。

属性文档