桌面应用 / 系统课时

用 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,否则可能与布局计算产生冲突。

当页面需要响应窗口变化时,优先使用布局描述“空间关系”,而不是描述“固定位置”。这样界面才能在不同分辨率和缩放比例下保持稳定。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 RowLayout 排横向内容

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

登录哪都通