【Qt6 QML Book 基础】15：常规模式 3 - 文档窗口（附完整可运行代码）

原创

于 2025-04-29 14:30:13 发布 · 1.0k 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#qt6 #c++ #qml6book #qt6qml #qml

引言

在桌面应用开发中，文档窗口模式是处理多文档场景的经典交互范式。用户通过独立窗口管理不同文档，支持新建、打开、保存等操作，并在关闭时自动提示未保存修改。Qt Quick 提供的 ApplicationWindow 与原生对话框组件，为实现这一模式提供了完整的解决方案。本文将结合实战代码，详解如何构建支持多文档管理的桌面应用界面，涵盖窗口创建、菜单交互、消息处理等核心功能。

一、运行效果图

1.1 文档窗口界面

核心布局：
- 每个文档独立为一个窗口，标题栏显示文件名及修改状态（* 表示未保存）；
- 顶部菜单栏包含 “文件” 菜单，提供新建、打开、保存等标准操作；
- 关闭未保存文档时弹出警告对话框，支持保存、放弃或取消操作。

1.2 关键交互场景

新建文档：点击 “新建” 创建空白窗口，标题为 “文档”；
打开文件：通过文件对话框选择文件，动态创建窗口并显示文件名；
关闭提示：未保存修改时弹出对话框，引导用户选择保存、放弃或取消关闭。

二、文档窗口：多实例管理核心

2.1 交互流程

在后面的内容中我们将说明如何实现面向桌面、以文档为中心的用户界面。这个想法是每个文档都有一个窗口。打开新文档时，将打开一个新窗口。对于用户来说，每个窗口都是一个包含单个文档的自包含世界。

程序的代码从 ApplicationWindow 开始，其中包含 File 菜单，其中包含标准作：新建、打开、保存和另存。

2.2 文档窗口组件：ApplicationWindow 扩展

// DocumentWindow.qml（核心窗口组件）
import QtQuick.Controls
import Qt.labs.platform as NativeDialogs

// 主应用窗口定义
ApplicationWindow {
    id: root
    width: 640
    height: 480
    visible: true
    // 动态窗口标题（显示文件名及修改状态）
    title: (fileName.length === 0 ? qsTr("文档") : fileName) + (isDirty?"*":"") 

    // 标记文档是否有未保存的修改
    property bool isDirty: true
    // 当前文档文件名
    property string fileName
    // 处理窗口关闭时的状态标记
    property bool tryingToClose: false

}