桌面应用 / 系统课时
搭出桌面应用主框架
搭出桌面应用主框架
本篇将完成一个可扩展桌面应用外壳,使用 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 应用从简单示例逐步扩展为完整桌面软件。
按自己的节奏,确认真正理解。