桌面应用 / 系统课时

搭出桌面应用主框架

搭出桌面应用主框架

本篇将完成一个可扩展桌面应用外壳,使用 ApplicationWindow 作为入口,组合菜单、侧边导航和 StackView,让页面具备真实应用的组织方式。

学习目标

  • 理解 QML 桌面应用主窗口、导航和页面容器的组合方式
  • 使用 ApplicationWindow、MenuBar 和 StackView 搭建应用框架
  • 掌握后续增加业务页面时的结构扩展方法

设计桌面应用外壳结构

桌面应用通常不会把所有内容直接写在一个窗口中,而是将窗口、导航、页面和业务组件分离。ApplicationWindow 负责窗口生命周期,MenuBar 提供系统操作入口,StackView 管理页面切换。

当应用页面数量增加时,StackView 可以避免大量手动控制页面可见状态。页面通过 push 和 pop 进入或退出导航栈,结构更接近传统桌面应用的工作方式。

使用 QML 组合主窗口

下面示例展示一个最小可运行框架。实际项目中可以将页面组件拆分到独立的 QML 文件中,这里为了演示结构将页面内嵌。

qml
import QtQuick
import QtQuick.Controls

ApplicationWindow {
    width: 960
    height: 640
    visible: true
    title: 'Desktop App'

    menuBar: MenuBar {
        Menu {
            title: '文件'
            Action {
                text: '退出'
                onTriggered: Qt.quit()
            }
        }
    }

    Row {
        anchors.fill: parent

        ListView {
            width: 180
            model: ['首页', '设置']
            delegate: ItemDelegate {
                width: parent.width
                text: modelData
                onClicked: stack.push(pageComponent)
            }
        }

        StackView {
            id: stack
            anchors.fill: parent
            initialItem: pageComponent
        }
    }

    Component {
        id: pageComponent
        Rectangle {
            color: 'white'
            Text {
                anchors.centerIn: parent
                text: '页面内容'
            }
        }
    }
}

预期输出

text
启动应用后显示桌面窗口。
顶部存在“文件”菜单,左侧显示导航列表,右侧 StackView 显示当前页面。
点击导航项后页面进入 StackView。

规划可维护的页面切换

实际项目中,建议让每个页面成为独立 QML 组件,例如 HomePage.qml、SettingsPage.qml。主窗口只负责创建导航关系,不直接包含大量业务控件。

页面切换时需要明确哪些状态属于页面本身,哪些状态属于应用级共享状态。用户配置、登录状态等通常应该由单独的数据层管理,避免页面之间隐式依赖。

什么时候不该把所有内容放进 StackView

StackView 适合具有前后层级关系的页面导航,例如设置页、详情页和向导流程。如果应用主要是固定布局的多栏工作台,可以考虑使用 SplitView 或 TabBar 等组件,而不是强行套用页面栈结构。

合理划分窗口、导航和页面职责,可以让 QML 应用从简单示例逐步扩展为完整桌面软件。

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

目录与阅读设置

阅读设置

17

记录一个想法

搭出桌面应用主框架

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

登录哪都通