C

布局 QML 类型

为推送到 GridLayout、RowLayout 或 ColumnLayout 的项提供附加属性。更多信息...

导入语句import QtQuick.Layouts
从Qt Quick Ultralite 2.8

附加属性

详细描述

Layout 类型对象附加到布局的子项，以提供有关项的布局特定信息。附加对象的功能会影响布局如何排列项。

例如，如果默认值不满足要求，可以指定 minimumWidth、preferredWidth 和 maximumWidth。

当布局大小调整时，项目可能会增长或缩小。因此，项目具有一个最小尺寸、首选尺寸和一个最大尺寸。

如果未明确指定项的最小尺寸，则尺寸设置為0。如果未明确指定项的最大尺寸，则尺寸设置為Number.POSITIVE_INFINITY。

对于布局，隐式的最小和最大尺寸取决于布局的内容。

属性fillWidth和fillHeight可以是true或false。如果它们设置为false，则项的尺寸将固定为其首选尺寸。否则，当布局大小调整时，它将在最小和最大尺寸之间增长或缩小。如果有多个项具有fillWidth（或fillHeight）设置为true，布局将根据它们首选尺寸的比例来增长或缩小项。

有关布局算法的更多详细信息，请参阅Qt Quick 布局概述。

注意：请不要绑定到布局中项的x、y、width或height属性，因为这会与布局的目标冲突，也可能导致绑定循环。width和height属性被布局引擎用来存储项的当前尺寸，这是根据最小/首选/最大附加属性计算得出的，可以在每次项布局时被覆盖。请使用Layout.preferredWidth和Layout.preferredHeight，或者implicitWidth和implicitHeight来指定项的首选尺寸。

另请参阅：GridLayout、RowLayout和ColumnLayout。

附加属性文档

Layout.alignment : Qt.Alignment

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

默认值为0，这意味着它将使用Qt.AlignVCenter | Qt.AlignLeft。如果仅指定水平或垂直标志，这些默认值也适用：如果只指定水平标志，则默认的垂直标志为Qt.AlignVCenter，如果只指定垂直标志，则默认的水平标志为Qt.AlignLeft。

一个有效的对齐方式是以下标记的组合


Layout.bottomMargin : int

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

另请参阅margins。


[default] Layout.column : int

此属性允许您在GridLayout中指定项的列位置。

如果row和此属性都没有设置，则布局将分配一个单元格给项。

另请参阅row和columnSpan。


[默认] 布局.columnSpan : int

此属性允许您指定GridLayout中项目的列跨度。

另请参阅 行跨度 和 列。


布局.fillHeight : bool

如果此属性为 true，则项目将在尊重给定约束的同时尽可能高。如果属性为 false，则项目将有一个固定高度，设置为首选高度。默认为 false，除非是布局本身，其默认为 true。

另请参阅 填充宽度。


布局.fillWidth : bool

如果此属性为 true，则项目将在尊重给定约束的同时尽可能宽。如果属性为 false，则项目将有一个固定宽度，设置为首选宽度。默认为 false，除非是布局本身，其默认为 true。

另请参阅 填充高度。


布局.leftMargin : int

指定项目外的左边距。如果没有设置值，将使用从 边距 获取的值。

另请参阅margins。


[默认] 布局.margins : int

将项目的所有边距设置为相同的值。项目本身不会评估自己的边距。这是父元素的责任来决定是否想要评估边距。

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

结合边距和对齐将使项目 包括 其边距进行对齐。例如，垂直居中的项如果顶部边距为 1、底部边距为 9，则将使项目在单元格中的实际对齐位置比中心高4像素。

另请参阅 左边距、顶部边距、右边距 和 底部边距。


布局.maximumHeight : int

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

如果项是布局，则隐式最大高度将是布局在没有任何项目超越其最大高度的情况下可以拥有的最大高度。任何其他项的隐式最大高度是 Number.POSITIVE_INFINITY。

-1 将将高度重置为其隐式最大高度。 ?>

另请参阅 最小高度 和 推荐高度。


布局.maximumWidth : int

此属性包含布局中项的最大宽度。默认值是项的隐式最大宽度。

如果项是一个布局，则隐含的最大宽度将是布局可以拥有的最大宽度，其子项无任何超出最大宽度。其他任何项的隐含最大宽度是 Number.POSITIVE_INFINITY。

将该值设置为 -1 将将宽度重置为其隐含最大宽度。

另请参阅 minimumWidth 和 preferredWidth。


Layout.minimumHeight : int

此属性存放布局中一个项的最小高度。默认值是项的隐含最小高度。

如果项是一个布局，则隐含的最小高度将是布局可以具有的最小高度，其子项无任何低于最小高度。其他任何项的隐含最小高度是 0。

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

另请参阅 preferredHeight 和 maximumHeight。


Layout.minimumWidth : int

此属性存放布局中一个项的最小宽度。默认值是项的隐含最小宽度。

如果项是一个布局，则隐含的最小宽度将是布局可以具有的最小宽度，其子项无任何低于最小宽度。其他任何项的隐含最小宽度是 0。

将该值设置为 -1 将将宽度重置为其隐含最小宽度。

另请参阅 preferredWidth 和 maximumWidth。


[默认] Layout.preferredHeight : int

此属性存放布局中一个项的首选高度。如果首选高度为 -1，它将被忽略，布局将使用 implicitHeight 代替。

另请参阅 minimumHeight 和 maximumHeight。


[默认] Layout.preferredWidth : int

此属性存放布局中一个项的首选宽度。如果首选宽度为 -1，它将被忽略，布局将使用 implicitWidth 代替。

另请参阅 minimumWidth 和 maximumWidth。


Layout.rightMargin : int

指定项外部的右侧外边距。如果没有设置值，它将使用 margins 中的值。

另请参阅margins。


[默认] Layout.row : int

此属性允许你指定项在 GridLayout 中的行位置。

如果 column 和此属性都没有设置，则布局分配单元格给项的工作由布局完成。

另请参阅 column 和 rowSpan。


[默认] Layout.rowSpan : int

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

另请参阅 columnSpan 和 row。


Layout.topMargin : int

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

另请参阅margins。


适用于某些 Qt 许可证。
了解更多信息。