桌面应用 / 系统课时
用 ColumnLayout 排纵向页面
用 ColumnLayout 排纵向页面
本节解决 QML 页面中纵向排列内容容易失控的问题。通过 ColumnLayout 可以组织表单、设置页和信息面板,让控件按照垂直方向自动排列,并在高度变化时保持合理间距。
学习目标
- 理解 ColumnLayout 的排列规则和适用场景
- 掌握垂直方向上的尺寸控制方法
- 能够使用布局构建稳定的纵向页面结构
使用 ColumnLayout 组织垂直内容
很多桌面页面包含标题、输入项、说明文字和操作按钮。如果通过 y 坐标逐个定位,当增加或删除内容时,需要重新计算所有位置。
ColumnLayout 会按照子控件声明顺序从上到下排列,并自动处理间距和尺寸调整。
qml
import QtQuick
import QtQuick.Controls
import QtQuick.Layouts
ApplicationWindow {
visible: true
width: 400
height: 400
ColumnLayout {
anchors.fill: parent
anchors.margins: 24
spacing: 12
Label {
text: "用户设置"
}
TextField {
placeholderText: "用户名"
Layout.fillWidth: true
}
TextField {
placeholderText: "邮箱"
Layout.fillWidth: true
}
Button {
text: "保存"
Layout.alignment: Qt.AlignRight
}
}
}预期结果
text
窗口显示标题、两个输入框和保存按钮。
输入框占据可用宽度,按钮保持靠右排列。控制纵向尺寸变化
ColumnLayout 主要处理垂直方向的位置关系。子控件可以通过 Layout 属性参与高度计算。
常用场景如下:
| 需求 | 设置方式 |
|---|---|
| 内容区域占满剩余高度 | Layout.fillHeight: true |
| 保持固定高度 | Layout.preferredHeight |
| 限制最小显示区域 | Layout.minimumHeight |
| 调整控件之间距离 | spacing |
例如编辑器页面通常希望中间内容区域随窗口增长:
qml
ColumnLayout {
anchors.fill: parent
Label {
text: "标题"
}
TextArea {
Layout.fillWidth: true
Layout.fillHeight: true
}
Button {
text: "提交"
}
}预期结果
text
标题和提交按钮保持在顶部和底部。
窗口高度增加时,文本区域自动扩展。嵌套布局构建页面结构
实际页面通常不会只有单一方向布局。例如一个设置页面可能是外层 ColumnLayout 管理多个区域,内部再使用 RowLayout 管理标签和输入框。
嵌套布局时,每一层只负责自己的空间关系:外层管理区域上下排列,内层管理区域内部横向排列。
ColumnLayout 适合动态内容高度变化的页面结构。只要明确哪些区域需要扩展、哪些区域需要保持固定,布局系统就能替代大量手工尺寸计算。
按自己的节奏,确认真正理解。