Provides attached properties for items pushed onto a GridLayout , RowLayout or ColumnLayout . 更多...
| import 语句： | import QtQuick.Layouts |
(since QtQuick.Layouts 1.2)
(since Qt 6.5)
(since QtQuick.Layouts 1.2)
(since QtQuick.Layouts 1.2)
(since QtQuick.Layouts 1.2)
(since QtQuick.Layouts 1.2)
(since Qt 6.5)
An object of type Layout is attached to children of the layout to provide layout specific information about the item. The properties of the attached object influence how the layout will arrange the items.
For instance, you can specify minimumWidth , preferredWidth ，和 maximumWidth if the default values are not satisfactory.
When a layout is resized, items may grow or shrink. Due to this, items have a 最小大小 , preferred size 和 maximum size .
If minimum size has not been explicitly specified on an item, the size is set to
0
. If maximum size has not been explicitly specified on an item, the size is set to
Number.POSITIVE_INFINITY
.
For layouts, the implicit minimum and maximum sizes depend on the content of the layouts.
The
fillWidth
and
fillHeight
properties can either be
true
or
false
. If they are
false
, the item's size will be fixed to its preferred size. Otherwise, it will grow or shrink between its minimum and maximum size as the layout is resized. If there are multiple items with
fillWidth
(或
fillHeight
) set to
true
, the layout will grow or shrink the items relative to the ratio of their preferred size.
For more details on the layout algorithm, see also the Qt Quick Layouts 概述 .
注意： Do not bind to the x, y, width, or height properties of items in a layout, as this would conflict with the goals of Layout, and can also cause binding loops. The width and height properties are used by the layout engine to store the current size of items as calculated from the minimum/preferred/maximum attached properties, and can be ovewritten each time the items are laid out. Use Layout.preferredWidth and Layout.preferredHeight ，或 implicitWidth and implicitHeight to specify the preferred size of items.
另请参阅 GridLayout , RowLayout ，和 ColumnLayout .
|
Layout.alignment : Qt . Alignment |
This property allows you to specify the alignment of an item within the cell(s) it occupies.
默认值为
0
, which means it will be
Qt.AlignVCenter | Qt.AlignLeft
. These defaults also apply if only a horizontal or vertical flag is specified: if only a horizontal flag is specified, the default vertical flag will be
Qt.AlignVCenter
, and if only a vertical flag is specified, the default horizontal flag will be
Qt.AlignLeft
.
A valid alignment is a combination of the following flags:
|
Layout.bottomMargin
:
real
|
Specifies the bottom margin outside of an item. If the value is not set, it will use the value from margins .
This property was introduced in QtQuick.Layouts 1.2.
另请参阅 margins .
|
Layout.column : int |
This property allows you to specify the column position of an item in a GridLayout .
If both row and this property are not set, it is up to the layout to assign a cell to the item.
默认值为
0
.
另请参阅 row and columnSpan .
|
Layout.columnSpan : int |
This property allows you to specify the column span of an item in a GridLayout .
默认值为
1
.
|
Layout.fillHeight : bool |
若此特性为
true
, the item will be as tall as possible while respecting the given constraints. If the property is
false
, the item will have a fixed height set to the preferred height. The default depends on implicit (built-in) size policy of the item.
另请参阅 fillWidth .
|
Layout.fillWidth : bool |
若此特性为
true
, the item will be as wide as possible while respecting the given constraints. If the property is
false
, the item will have a fixed width set to the preferred width. The default depends on implicit (built-in) size policy of item.
另请参阅 fillHeight .
|
Layout.horizontalStretchFactor
:
int
|
This property allows you to specify the horizontal stretch factor. By default, two identical items arranged in a linear layout will have the same size, but if the first item has a stretch factor of 1 and the second item has a stretch factor of 2, the first item will aim to get 1/3 of the available space, and the second will aim to get 2/3 of the available space. Note that, whether they become exactly 1/3 and 2/3 of the available space depends on their size hints. This is because when e.g a horizontal layout is shown in its minimum width all its child items will consequently also have their minimum width.
Likewise, when a horizontal layout has its preferred width, all child items will have their preferred widths, and when a horizontal layout has its maximum width, all child items will have their maximum widths. This strategy is applied regardless of what the individual stretch factors are. As a consequence of this, stretch factors will only determine the growth rate of child items between the preferredWidth and maximumWidth range.
默认值为
-1
, which means that no stretch factor is applied.
注意： This requires that Layout::fillWidth is set to true
该特性在 Qt 6.5 引入。
另请参阅 verticalStretchFactor .
|
Layout.leftMargin
:
real
|
Specifies the left margin outside of an item. If the value is not set, it will use the value from margins .
This property was introduced in QtQuick.Layouts 1.2.
另请参阅 margins .
|
Layout.margins
:
real
|
Sets the margins outside of an item to all have the same value. The item itself does not evaluate its own margins. It is the parent's responsibility to decide if it wants to evaluate the margins.
Specifically, margins are only evaluated by ColumnLayout , RowLayout , GridLayout , and other layout-like containers, such as SplitView , where the effective cell size of an item will be increased as the margins are increased.
Therefore, if an item with margins is a child of another
Item
, its position, size and implicit size will remain unchanged.
Combining margins with alignment will align the item
包括
its margins. For instance, a vertically-centered Item with a top margin of
1
and a bottom margin of
9
will cause the Items effective alignment within the cell to be 4 pixels above the center.
默认值为
0
.
This property was introduced in QtQuick.Layouts 1.2.
另请参阅 leftMargin , topMargin , rightMargin ，和 bottomMargin .
|
Layout.maximumHeight : real |
The default value is the item's implicit maximum height.
If the item is a layout, the implicit maximum height will be the maximum height the layout can have without any of its items growing beyond their maximum height. The implicit maximum height for any other item is
Number.POSITIVE_INFINITY
.
Setting this value to
-1
will reset the height back to its implicit maximum height.
另请参阅 minimumHeight and preferredHeight .
|
Layout.maximumWidth : real |
This property holds the maximum width of an item in a layout. The default value is the item's implicit maximum width.
If the item is a layout, the implicit maximum width will be the maximum width the layout can have without any of its items growing beyond their maximum width. The implicit maximum width for any other item is
Number.POSITIVE_INFINITY
.
Setting this value to
-1
will reset the width back to its implicit maximum width.
另请参阅 minimumWidth and preferredWidth .
|
Layout.minimumHeight : real |
This property holds the minimum height of an item in a layout. The default value is the item's implicit minimum height.
If the item is a layout, the implicit minimum height will be the minimum height the layout can have without any of its items shrinking below their minimum height. The implicit minimum height for any other item is
0
.
Setting this value to -1 will reset the height back to its implicit minimum height.
另请参阅 preferredHeight and maximumHeight .
|
Layout.minimumWidth : real |
This property holds the minimum width of an item in a layout. The default value is the item's implicit minimum width.
If the item is a layout, the implicit minimum width will be the minimum width the layout can have without any of its items shrinking below their minimum width. The implicit minimum width for any other item is
0
.
Setting this value to -1 will reset the width back to its implicit minimum width.
另请参阅 preferredWidth and maximumWidth .
|
Layout.preferredHeight : real |
This property holds the preferred height of an item in a layout. If the preferred height is
-1
it will be ignored, and the layout will use
implicitHeight
instead. The default is
-1
.
另请参阅 minimumHeight and maximumHeight .
|
Layout.preferredWidth : real |
This property holds the preferred width of an item in a layout. If the preferred width is
-1
it will be ignored, and the layout will use
implicitWidth
instead. The default is
-1
.
另请参阅 minimumWidth and maximumWidth .
|
Layout.rightMargin
:
real
|
Specifies the right margin outside of an item. If the value is not set, it will use the value from margins .
This property was introduced in QtQuick.Layouts 1.2.
另请参阅 margins .
|
Layout.row : int |
This property allows you to specify the row position of an item in a GridLayout .
If both column and this property are not set, it is up to the layout to assign a cell to the item.
默认值为
0
.
|
Layout.rowSpan : int |
This property allows you to specify the row span of an item in a GridLayout .
默认值为
1
.
另请参阅 columnSpan and row .
|
Layout.topMargin
:
real
|
Specifies the top margin outside of an item. If the value is not set, it will use the value from margins .
This property was introduced in QtQuick.Layouts 1.2.
另请参阅 margins .
|
Layout.verticalStretchFactor
:
int
|
This property allows you to specify the vertical stretch factor. By default, two identical items arranged in a linear layout will have the same size, but if the first item has a stretch factor of 1 and the second item has a stretch factor of 2, the first item will aim to get 1/3 of the available space, and the second will aim to get 2/3 of the available space. Note that, whether they become exactly 1/3 and 2/3 of the available space depends on their size hints. This is because when e.g a vertical layout is shown in its minimum height all its child items will consequently also have their minimum height.
Likewise, when a vertical layout has its preferred height, all child items will have their preferred heights, and when a vertical layout has its maximum height, all child items will have their maximum heights. This strategy is applied regardless of what the individual stretch factors are. As a consequence of this, stretch factors will only determine the growth rate of child items between the preferredHeight and maximumHeight range.
默认值为
-1
, which means that no stretch factor is applied.
注意： This requires that Layout::fillHeight is set to true
该特性在 Qt 6.5 引入。
另请参阅 horizontalStretchFactor .