Layout QML Type

该属性允许您指定项目在其所占单元格中的对齐方式。

默认值为0 ，即Qt.AlignVCenter | Qt.AlignLeft 。如果只指定了水平或垂直标志，这些默认值也同样适用：如果只指定了水平标志，则默认垂直标志为Qt.AlignVCenter ，如果只指定了垂直标志，则默认水平标志为Qt.AlignLeft 。

有效的对齐方式是以下标志的组合：

• Qt::AlignLeft
• Qt::AlignHCenter
• Qt::AlignRight
• Qt::AlignTop
• Qt::AlignVCenter
• Qt::AlignBottom
• Qt::AlignBaseline

指定项目外部的底边距。如果未设置该值，将使用margins 中的值。

该属性在 QtQuick.Layouts 1.2 中引入。

另请参阅 margins 。

该属性允许您指定GridLayout 中项目的列位置。

如果row 和此属性均未设置，则由布局为项目指定单元格。

默认值为0 。

另请参阅 row 和columnSpan 。

该属性允许您在GridLayout 中指定项的列跨度。

默认值为1 。

另请参阅 rowSpan 和column 。

如果该属性为true ，则在遵守给定约束的前提下，项目将尽可能高。如果该属性为false ，则项目的固定高度将设置为首选高度。默认值取决于项目的隐式（内置）尺寸策略。

另请参阅 fillWidth 。

如果该属性为true ，项目将在遵守给定限制的前提下尽可能宽。如果该属性为false ，项目的固定宽度将设置为首选宽度。默认值取决于项目的隐式（内置）尺寸策略。

另请参阅 fillHeight 。

此属性允许您指定水平拉伸因子。默认情况下，在线性布局中排列的两个相同项目将具有相同的大小，但如果第一个项目的拉伸因子为 1，第二个项目的拉伸因子为 2，则第一个项目将争取获得可用空间的 1/3，第二个项目将争取获得可用空间的 2/3。需要注意的是，它们是否恰好成为可用空间的 1/3 和 2/3，取决于它们的大小提示。这是因为，当一个水平布局以最小宽度显示时，它的所有子项也将随之以最小宽度显示。

同样，当一个水平布局以其首选宽度显示时，所有子项也将以其首选宽度显示；而当一个水平布局以其最大宽度显示时，所有子项也将以其最大宽度显示。无论各个拉伸因子是多少，这一策略都会被应用。因此，拉伸因子只能决定preferredWidth 和maximumWidth 之间子项的增长率。

默认值为-1 ，即不应用拉伸因子。

此属性在 Qt 6.5 中引入。

另请参阅 verticalStretchFactor 。

指定项目外部的左侧边距。如果未设置该值，则将使用margins 中的值。

此属性在 QtQuick.Layouts 1.2 中引入。

另请参阅 margins 。

将项目外部的 margin 设置为相同值。项目本身不评估自己的边距。决定是否要评估边距是父项的责任。

具体来说，只有ColumnLayout,RowLayout,GridLayout 和其他类似布局的容器（如SplitView ）才会评估边距，在这些容器中，项目的有效单元格大小会随着边距的增加而增大。

因此，如果带边距的项目是另一个Item 的子项，其位置、大小和隐式大小将保持不变。

将页边距与对齐方式结合使用，将对齐包括页边距在内的项目。例如，一个垂直居中的项目，其上边距为1 ，下边距为9 ，这将导致该项目在单元格内的有效对齐方式为居中上方 4 像素。

默认值为0 。

该属性在 QtQuick.Layouts 1.2 中引入。

另请参阅 leftMargin,topMargin,rightMargin, 和bottomMargin 。

默认值是项目的隐式最大高度。

如果该项目是一个布局，则隐式最大高度将是该布局在其任何项目不超过其最大高度的情况下可具有的最大高度。任何其他项目的隐式最大高度都是Number.POSITIVE_INFINITY 。

将该值设置为-1 后，高度将重置为隐式最大高度。

另请参阅 minimumHeight 和preferredHeight 。

此属性用于保存布局中项目的最大宽度。默认值是项目的隐式最大宽度。

如果该项目是一个布局，则隐式最大宽度将是该布局在没有任何项目超出其最大宽度的情况下所能具有的最大宽度。任何其他项目的隐式最大宽度都是Number.POSITIVE_INFINITY 。

将该值设置为-1 后，宽度将重置为隐式最大宽度。

另请参阅 minimumWidth 和preferredWidth 。

该属性用于保存布局中项目的最小高度。默认值是项目的隐式最小高度。

如果该项目是一个布局，则隐式最小高度将是该布局在没有任何项目收缩到其最小高度以下时的最小高度。其他项目的隐式最小高度为0 。

将该值设置为-1 将重置高度为隐式最小高度。

另请参阅 preferredHeight 和maximumHeight 。

该属性用于保存布局中项目的最小宽度。默认值是项目的隐式最小宽度。

如果该项目是一个布局，则隐式最小宽度将是该布局在不使其任何项目收缩到最小宽度以下的情况下所能具有的最小宽度。其他项目的隐式最小宽度为0 。

将该值设置为-1 将使宽度重置为隐式最小宽度。

另请参阅 preferredWidth 和maximumWidth 。

该属性用于保存布局中项目的首选高度。如果首选高度是-1 ，它将被忽略，布局将使用implicitHeight 代替。默认值为-1 。

另请参阅 minimumHeight 和maximumHeight 。

该属性用于保存布局中项目的首选宽度。如果首选宽度为-1 ，它将被忽略，布局将使用implicitWidth 代替。默认值为-1 。

另请参阅 minimumWidth 和maximumWidth 。

指定项目外部的右边距。如果未设置该值，则将使用margins 中的值。

该属性在 QtQuick.Layouts 1.2 中引入。

另请参阅 margins 。

该属性允许您指定GridLayout 中项目的行位置。

如果column 和此属性均未设置，则由布局为项目指定单元格。

默认值为0 。

另请参阅 column 和rowSpan 。

该属性允许您在GridLayout 中指定项的行跨度。

默认值为1 。

另请参阅 columnSpan 和row 。

指定项目外部的顶边距。如果未设置该值，将使用margins 中的值。

该属性在 QtQuick.Layouts 1.2 中引入。

另请参阅 margins 。

该属性允许用户在组件级别配置布局尺寸策略。

默认值将通过查询应用程序属性Qt::AA_QtQuickUseDefaultSizePolicy 继承。您可以使用该属性覆盖该值。

此属性在 Qt 6.8 中引入。

该属性允许你指定垂直拉伸因子。默认情况下，在线性布局中排列的两个相同项目的大小相同，但如果第一个项目的拉伸因子为 1，第二个项目的拉伸因子为 2，则第一个项目的目标是获得可用空间的 1/3，第二个项目的目标是获得可用空间的 2/3。需要注意的是，它们是否恰好成为可用空间的 1/3 和 2/3，取决于它们的大小提示。这是因为，当一个垂直布局以最小高度显示时，它的所有子项也将随之以最小高度显示。

同样，当一个垂直布局以其首选高度显示时，所有子项也将以其首选高度显示；而当一个垂直布局以其最大高度显示时，所有子项也将以其最大高度显示。无论各个拉伸因子是多少，这一策略都会被应用。因此，拉伸因子只能决定preferredHeight 和maximumHeight 之间子项的增长率。

默认值为-1 ，即不应用拉伸因子。

此属性在 Qt 6.5 中引入。

另请参阅 horizontalStretchFactor 。