创建Document应用,默认情况下,启动应用就会弹出一个窗口,此时一个NSDocument对应一个NSWindowController。如果要new一个新的文档,这个时候就会弹出一个新的窗口。如果我们想要创建一个应用,每次new/open一个文档的时候,该文档都在一个窗口上创建或打开,就是用单窗口容纳多个文档(譬如浏览器用单窗口容纳多个标签页面,word文档用单窗口容纳多个文档),我们该怎么实现呢。
首先我们先搞清楚NSDocumentController、NSDocument、NSWindowController、NSWindow四者的关系,通常情况下,文档应用只有一个NSDocumentController对象。新建一个文档过程:首先创建一个NSDocument对象,这个对象会被NSDocumentController对象调用addDocument方法来加到自己的documents容器去,然后系统会调用文档的makeWindowControllers方法来创建自己的NSWindowController对象,将NSDocument与NSWindowController一一匹配。makeWindowControllers默认实现就是加载指定的nib文件来创建自己的windowcontroller。为了实现单窗口多文档,这个时候我们就需要一个NSWindowController对应N个NSDocument,我们需要重载NSWindowController来实现我们自己的windowController,且该windowController支持单例模式,就是只有唯一的一个NSWindowController对象,这样就只有唯一的一个文档窗口(NSWindowController对应一个NSWindow,也对应一个包含window的nib/xib文件)。
makeWindowControllers实现代码:
- (void)makeWindowControllers{
[self addWindowController:[MyMainWindowController shareMainWindowController]];
}
虽然说这样实现可以保证我们新建或打开文档都只有唯一个窗口,但是如何将多文档在一个窗口显示呢?首先我想到的实现方式是用两个NSCollectionView来实现,一个用来装标签,另一个用来装文档,当我们新建一个文档的时候,我们就让两个collectionView同时reloadData来刷新界面,有多少个文档,就有多少个标签,一个文档与一个标签一一对应。实现逻辑是想到了,但是问题是在哪里调用reloadData来刷新界面是关键。
这个时候我们就要来理清楚新建文档、打开文档、打开最近、本地目录双击文件打开、应用异常后下次自动打开都会涉及到那些内部函数了。通过跟踪这些步骤发现,只需要重载三个函数:
1,新建文件
- (__kindof NSDocument *)openUntitledDocumentAndDisplay:(BOOL)displayDocument error:(NSError *__autoreleasing _Nullable *)outError;
2,打开文件,打开最近菜单文件,双击文件打开应用会调用这个函数
- (void)openDocumentWithContentsOfURL:(NSURL *)url display:(BOOL)displayDocument completionHandler:(void (^)(NSDocument * _Nullable, BOOL, NSError * _Nullable))completionHandler;
3,保存过的文件再编辑异常后,或者新建文件编辑后没保存过异常会调用这个函数来打开
- (void)reopenDocumentForURL:(NSURL *)urlOrNil withContentsOfURL:(NSURL *)contentsURL display:(BOOL)displayDocument completionHandler:(void (^)(NSDocument * _Nullable, BOOL, NSError * _Nullable))completionHandler;
我们只需要重载这三个函数,添加我们的刷新两个NSCollectionView的代码,就能实现单窗口多标签文档。
到这里似乎好像就已经完成了单窗口多标签文档了,但其实还没有完的。我们知道系统默认是一个NSDocument对应一个NSWindowController的,此时我们窗口上有多个文档,而只有一个NSWindowController,而NSWindowController它有一个成员document,就是记录NSWindowController对应的文档。现在乍看完了,怎么办,好像需要一一对应,感觉做不到单窗口对应多文档了。
首先我想到的是,我们能不能在点击标签的时候相应的修改document变量到正确的文档去,就是相应的切换NSDocumentController的currentDocument对象,通过修改document变量好像还真的相应的改变了currentDocument,但是还是发现问题了,当我编辑了一个文档后,切换到另一个文档后再切换回来,我的编辑状态丢失了(就是标题栏中-Edited标志不见了,该文档相当于没编辑过了,如果关闭窗口或关闭应用,不会询问是否要保存文档而只会默认关闭导致数据丢失了)。换句话说,简单的赋值document来改变currentDocument是有问题的,查看document属性相关文档,也建议不要修改该变量。这下彻底没辙了,还有办法在点击标签切换文档时能改变NSWindowController中的document属性和NSDocumentController中的currentDocument吗?
答案是有的,我们只需要在点击标签切换文档的时候调用文档的makeWindowControllers方法,它会帮我们实现这一切,真的是谢天谢地啊。(关于点击标签展示相应的文档只需要滚动到相应的文档位置,而鼠标滑动文档切换也只需要变更标签的选中状态来表示标签变化,这些都很好实现就不一一讨论)
到这里我们基本已经实现了单窗口多标签文档的编辑保存及在打开,但是还有最后一个问题需要解决。虽然在退出应用的时候系统会咨询我们是否要处理多个编辑过的文档,这个时候我们保存或者不处理都没有问题。但是,如果编辑过多个文档后点击窗口的关闭按钮就没有那么顺利了,因为此刻的window只知道一个文档,就是NSWindowController的属性document记录的那个文档,也是NSDocumentController中的currentDocument。系统只会询问是否处理该文档,而其它文档会忽略掉。下次打开应用的时候,因为之前有些文档并没有从NSDocumentController中移除,系统会当是异常了而重新打开那些文档。虽然似乎没什么问题,但显然这不是我们要的结果。我们想当然是希望我们点击窗口关闭按钮的时候跟退出应用一样,能询问我们时候处理所有编辑过的文档,而不是只处理当前文档。
此时,我们要做的事情就是重新实现窗口关闭的功能啦。具体如下:
NSButton* closeButton = [self.window standardWindowButton:NSWindowCloseButton];
[closeButton setTarget:self];
[closeButton setAction:@selector(closeWindow:)];
closeWindow的实现,一个简单的方式就是调用终止应用的代码,这个时候点击窗口关闭和退出应用的过程如出一辙,都会提示是否要处理编辑过的文档。但又有问题,此时应用会完全退出啦,如果我们只想做到关闭窗口而不退出应用,我们可以遍历documents对象,逐个检查是否编辑过,编辑过的文档调用- (void)canCloseDocumentWithDelegate:(id)delegate shouldCloseSelector:(SEL)shouldCloseSelector contextInfo:(void *)contextInfo来弹出窗口来处理。
到这里基本解决所有遇到的问题了,通常我们可能还想把NSCollectionView中的滚动条隐藏掉。看似隐藏滚动条是非常简单的事,但如果大家在添加NSCollectionView的时候是直接在xib/nib可视文档上添加的,那就会遇到设置NSScrollView的NSScroller隐藏无效,怎么自定义都没用,关于如何隐藏滚动条请参考我写的另外一篇文章了。文章链接
网友评论