桌面应用 / 系统课时

用 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 适合动态内容高度变化的页面结构。只要明确哪些区域需要扩展、哪些区域需要保持固定,布局系统就能替代大量手工尺寸计算。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 ColumnLayout 排纵向页面

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通