Tiled源码分析(二): 多文档支持

文档模型

文档对象是一个MapDocument类, 它的主要功能有:

• 管理编辑操作的signal的派发, 保证一些UI的状态可以正确地更新
• 管理地图的数据模型, 如layer model(Qt MVC结构中的model, 可以绑定到控件)
• 增加删除地图对象的操作接口
• 管理这个地图的undo堆栈(后续专门分析一下undo/redo)
• 管理地图编辑时的选中状态

然后就是DocumentManager, 是一个单件类, 用于管理打开的所有MapDocument, 看看它都有些什么:

• 持有一个QTabWidget, 这个控件就是MainWindow的center widget, 所一直是最大化居中显示的
• 持有一个QUndoGroup, 因为每个MapDocument都有一个QUndoStack, 所以算是一个undo管理器(Qt这点很人性化, 常用功能都封装好了)
• 管理当前文档, 以及切换状态. 每当当前文档变化时, 都会发出一个currentDocumentChanged的signal

文档操作

不管什么编辑器, 针对文档的操作就这么几种, 看看所有编辑器工具栏上那万年不变的前几个图标就知道了.

新建

先弹出NewMapDialog, 确定各种参数后就会生成一个MapDocument对象

让人意外的是MapDocument是NewMapDialog创建的, 而不是DocumentManager

估计这么做的原因是参数太多, 私有访问比较方便吧?

然后调用DocumentManager::addDocument把文档加入管理器, 同时创建显示需要的一些东西, 并绑定事件

打开

在读取之前, 会先查询一下插件管理器, 看看有没有可以读文件的插件

如果选择的文件已经打开, 则直接切换到那个文档, 不再打开新的

读完文件后就有了Map对象, 创建出MapDocument, 剩下的流程就跟新建一样addDocument就行了

关闭

关闭之前需要确认保存, 而需不需要保存则是看QUndoStack是不是空的(跟我之前YY的一样)

DocumentManager干的事就是删除Tab, 释放显示对象和MapDocument对象

保存

如果没有名字, 就换成"另存为"的操作流程

保存的时候同样也要扫描插件看扩展的格式writer

保存完的话就要把文档对应的QUndoStack标记空了, 这样就不会出现没有修改重复保存的情况

最后就把文件加入"recent file"

最近打开文件记录

这个打开记录是保存在QSettings里的, 在编辑器下次启动时也会还原打开的文件

QSettings是个之前没用过的东西, 可以保存各种选项, 而且还不用操作保存/读取, 挺实用的

总结

这么看下来多文档模型还是挺清晰的, 最重要的是管理好状态切换