如何实现单窗口多标签文档Mac应用

创建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隐藏无效,怎么自定义都没用,关于如何隐藏滚动条请参考我写的另外一篇文章了。文章链接

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 225,641评论 6 525
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 96,754评论 3 408
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 173,075评论 0 370
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 61,369评论 1 303
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 70,386评论 6 402
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 53,800评论 1 317
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 42,122评论 3 431
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 41,130评论 0 281
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 47,689评论 1 327
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 39,693评论 3 348
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 41,804评论 1 356
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 37,399评论 5 351
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 43,128评论 3 341
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 33,528评论 0 25
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 34,705评论 1 278
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 50,409评论 3 383
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 46,878评论 2 368

推荐阅读更多精彩内容