行 QML 类型

将子元素放置在同一行中。更多...

导入声明	import QtQuick
继承	Item

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

属性

add : Transition
bottomPadding : real
effectiveLayoutDirection : enumeration
layoutDirection : enumeration
leftPadding : real
move : Transition
padding : real
populate : Transition
rightPadding : real
spacing : real
topPadding : real

信号

positioningComplete()

方法

forceLayout()

详细描述

Row 是一种类型，可将子元素定位到单行中。它可以作为一种方便的方式用于水平定位一系列项目，而无需使用锚点。

以下是一个包含三种不同尺寸矩形的 Row

import QtQuick

Row {
    spacing: 2
    Rectangle { color: "red"; width: 50; height: 50 }
    Rectangle { color: "green"; width: 20; height: 50 }
    Rectangle { color: "blue"; width: 50; height: 20 }
}

Row 将这些项目自动定位为横向排列，如下所示

如果在 Row 中的某个项目不可见，或其宽度或高度为 0，则该项目将不会被布局，并且在行中也不会可见。此外，由于 Row 自动对其子项进行水平定位，因此在 Row 中的子项不应设置其 x 位置或使用 left、right、horizontalCenter、fill 或 centerIn 锚点在其水平上锚定自己。如果您需要进行这些操作，请考虑不使用 Row 来定位项目。

请注意，行中的项目可以使用附加的 Positioner 属性来访问有关其在行中位置的其他信息。

有关使用 Row 和其他相关位置器类型的信息，请参阅项位置器。

也请参阅 列、网格、流、定位器、行布局，以及 Qt Quick 示例 - 定位器。

属性文档

底部填充 : 实数

左边距 : 实数

填充 : 实数

右边距 : 实数

顶部填充 : 实数

这些属性包含内容周围的填充。

添加 : 转场

这个属性包含添加到此定位器中的项目要运行的转场。对于定位器，这适用于

在定位器创建后创建或重归档为定位器子项的项目
子项更改其 Item::visible 属性从 false 到 true，从而现在是可见的

转场可以使用 ViewTransition 属性来访问要添加的项目更详细的信息。有关使用这些转场的更多详细信息，请参阅 ViewTransition 文档。

注意： 此转场不应用于其创建时已是定位器一部分的项目。在这种情况下，将应用 populate 转场。

也请参阅 populate、ViewTransition，以及 Qt Quick 示例 - 定位器。

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

此属性包含行的有效布局方向。

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

也请参阅 Row::layoutDirection 和 LayoutMirroring。

布局方向 : 枚举

此属性包含行的布局方向。

可能值

常量	描述
`Qt.LeftToRight`	(默认) 从左到右布局项目。如果显式设置了行的宽度，则左锚点保持在行的左侧。
`Qt.RightToLeft`	从右到左布局项目。如果显式设置了行的宽度，则右锚点保持在行的右侧。

也请参阅 Grid::layoutDirection 和 Flow::layoutDirection。

移动 : 转场

此属性包含运行于定位器内部移动的项目时所使用的转场。对于定位器，这适用于

由于定位器中其他项目的添加、删除或重新排列而移动的子项
由于定位器中其他项目的大小调整而重新定位的子项

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

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

populate : Transition

此属性保存创建位置器时要运行的过渡。当位置器首次创建时，将运行此过渡。

转场可以使用 ViewTransition 属性来访问要添加的项目更详细的信息。有关使用这些转场的更多详细信息，请参阅 ViewTransition 文档。

另请参阅 add、ViewTransition 和 Qt Quick 示例 - 定位器。

spacing : real

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

另请参阅 Grid::spacing。

信号文档

positioningComplete()

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

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

方法文档

forceLayout()

行通常在每一帧中对子项进行定位一次。这意味着在脚本块内部，底层子项可能会发生变化，但行尚未相应更新。

此方法迫使行立即对其子项中的任何挂起的更改做出反应。

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