桌面应用 / 系统课时
用 RowLayout 排横向内容
用 RowLayout 排横向内容
本节解决 QML 中横向排列控件时手动计算位置的问题。通过 RowLayout 和 Layout 附加属性,可以让按钮、输入框等组件根据可用空间自动分配尺寸,并保持稳定的布局行为。
学习目标
- 理解 RowLayout 与普通 x/y 定位方式的区别
- 掌握 Layout 附加属性控制控件尺寸和伸缩行为
- 能够构建可适应窗口变化的横向界面
认识 RowLayout 的布局方式
在桌面应用中,横向工具栏、表单字段组合和操作区域经常需要多个控件保持同一行排列。如果直接设置每个控件的 x 坐标,窗口尺寸变化后容易出现重叠或空白。
RowLayout 属于 Qt Quick Layouts 模块,它按照从左到右的顺序排列子控件,并根据控件的布局参数决定最终尺寸。
使用布局前需要导入对应模块:
qml
import QtQuick
import QtQuick.Controls
import QtQuick.Layouts使用 Layout 属性控制尺寸
RowLayout 不直接修改子控件的宽高,而是读取控件上的 Layout 附加属性。常用属性包括:
| 属性 | 作用 |
|---|---|
| Layout.minimumWidth | 控件允许的最小宽度 |
| Layout.preferredWidth | 希望占用的默认宽度 |
| Layout.fillWidth | 是否占用剩余水平空间 |
| Layout.alignment | 控件在布局中的对齐方式 |
例如,一个搜索区域通常希望输入框扩展,而按钮保持固定大小:
qml
import QtQuick
import QtQuick.Controls
import QtQuick.Layouts
ApplicationWindow {
visible: true
width: 600
height: 120
RowLayout {
anchors.fill: parent
anchors.margins: 20
spacing: 10
TextField {
placeholderText: "输入关键词"
Layout.minimumWidth: 120
Layout.fillWidth: true
}
Button {
text: "搜索"
Layout.preferredWidth: 90
}
}
}预期结果
text
窗口打开后显示输入框和搜索按钮。
当窗口水平扩大时,输入框自动增加宽度,按钮保持接近固定尺寸。理解伸缩比例与空间分配
多个控件同时设置 Layout.fillWidth 时,它们会共同分配剩余空间。默认情况下,布局会根据首选尺寸和可用空间进行调整。
如果需要控制比例,可以使用 Layout.horizontalStretchFactor。例如两个区域希望按照 1:2 分配宽度:
qml
RowLayout {
anchors.fill: parent
Rectangle {
color: "lightgray"
Layout.fillWidth: true
Layout.horizontalStretchFactor: 1
}
Rectangle {
color: "darkgray"
Layout.fillWidth: true
Layout.horizontalStretchFactor: 2
}
}预期结果
text
两个矩形填满窗口宽度。
右侧区域占用的水平空间约为左侧区域的两倍。RowLayout 常见使用边界
RowLayout 适合描述同一层级的横向排列关系,例如导航栏、按钮组和工具栏。如果界面存在复杂嵌套关系,应组合多个布局,而不是依靠大量尺寸计算。
需要注意,使用 Layout 时不要同时手动设置子控件的 x、y、width,否则可能与布局计算产生冲突。
当页面需要响应窗口变化时,优先使用布局描述“空间关系”,而不是描述“固定位置”。这样界面才能在不同分辨率和缩放比例下保持稳定。
按自己的节奏,确认真正理解。