Flow QML 类型

将其子项水平放置，并在必要时自动换行。更多...

导入语句	import QtQuick
继承	Item

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

属性

add : Transition
bottomPadding : 实数
effectiveLayoutDirection : 枚举类型
flow : 枚举类型
layoutDirection : 枚举类型
leftPadding : 实数
move : Transition
padding : 实数
populate : Transition
rightPadding : 实数
spacing : 实数
topPadding : 实数

信号

positioningComplete()

方法

forceLayout()

详细描述

The Flow item positions its child items like words on a page, wrapping them to create rows or columns of items.

以下是一个包含各种 Text 项的 Flow

    Flow {
        anchors.fill: parent
        anchors.margins: 4
        spacing: 10

        Text { text: "Text"; font.pixelSize: 40 }
        Text { text: "items"; font.pixelSize: 40 }
        Text { text: "flowing"; font.pixelSize: 40 }
        Text { text: "inside"; font.pixelSize: 40 }
        Text { text: "a"; font.pixelSize: 40 }
        Text { text: "Flow"; font.pixelSize: 40 }
        Text { text: "item"; font.pixelSize: 40 }
    }

The Flow item automatically positions the child Text items side by side, wrapping as necessary

If an item within a Flow is not visible, or if it has a width or height of 0, the item will not be laid out and it will not be visible within the Flow. Also, since a Flow automatically positions its children, a child item within a Flow should not set its x or y positions or anchor itself with any of the anchor properties.

有关使用 Flow 和其他相关定位类型的信息，请参阅 Item Positioners。

另请参阅 Column，Row，Grid，Positioner 和 Qt Quick 示例 - 定位器。

属性文档

bottomPadding : 实数

leftPadding : 实数

padding : 实数

rightPadding : 实数

上边距 : 实数

这些属性保存了内容周围的填充。

add : 过渡

此属性保存了对添加到此位置器位置的项运行的过渡。对于位置器来说，这适用于

在位置器创建后创建或作为位置器的子项重新父化的项
子项属性从 Item::visible 从 false 改为 true，因此现在可见

过渡可以使用 ViewTransition 属性访问正在添加的项的更多详情。有关使用这些过渡的更多信息和示例，请参阅ViewTransition 文档。

注意：此过渡不会应用于创建时的位置器中已有的项。在这种情况下，应用 populate 过渡。

另请参阅：populate、ViewTransition 和 Qt Quick 示例 - 位置器。

有效的布局方向 : 枚举 [只读]

此属性保存流的实际布局方向。

使用附加属性 LayoutMirroring::enabled 进行区域布置时，网格位置器的视觉布局方向将被镜像。但是，属性 layoutDirection 将保持不变。

另请参阅：Flow::layoutDirection 和 LayoutMirroring。

flow : 枚举

此属性保存布局的流向。

可能值包括

Flow.LeftToRight（默认）- 项按照 layoutDirection 按照顺序相邻排列，直到超出流的宽度，然后换行。
Flow.TopToBottom - 项从上到下相邻排列，直到超出流的高度，然后换列。

layoutDirection : 枚举

此属性保存布局的布局方向。

可能值包括

Qt.LeftToRight（默认）- 项从顶部到底部、从左到右排列。流方向依赖于 Flow::flow 属性。
Qt.RightToLeft - 项从顶部到底部、从右到左排列。流方向依赖于 Flow::flow 属性。

另请参阅：Grid::layoutDirection 和 Row::layoutDirection。

move : 过渡

此属性保存运行于位置器内部移动的项的过渡。对于位置器来说，这适用于

由于在其他项的添加、删除或重新排列而位移的子项
由于位置器中其他项的尺寸更改而重新定位的项

过渡可以用于 ViewTransition 属性，以访问正在移动的项目更多细节。注意，然而，对于这种移动过渡，ViewTransition.targetIndexes 和 ViewTransition.targetItems 列表只在通过放置器添加其他项触发此过渡时设置；在其他情况下，这些列表将为空。有关这些过渡的更多详细信息和使用示例，请参阅 ViewTransition 文档。

另请参阅 add、populate、ViewTransition 和 Qt Quick 示例 - 放置器。

populate : Transition

此属性在创建时保存属于此放置器的项目的过渡。放置器首次创建时运行此过渡。

过渡可以使用 ViewTransition 属性访问正在添加的项的更多详情。有关使用这些过渡的更多信息和示例，请参阅ViewTransition 文档。

另请参阅 add、ViewTransition 和 Qt Quick 示例 - 放置器。

spacing : real

spacing 是留空的像素量，相邻项之间的间距，默认为0。

另请参阅 Grid::spacing。

信号文档

positioningComplete()

当定位完成时发出此信号。

注意：对应的处理程序是 onPositioningComplete。

方法文档

forceLayout()

Flow 通常在每个帧中对子项进行定位一次。这意味着在脚本块内，底层子项可能已经更改，但 Flow 还未相应地更新。

此方法强制 Flow 立即对其子项的任何未决更改做出响应。

注意：通常应在组件完成之后调用方法。