首页 » iOS编程基础:Swift、Xcode和Cocoa入门指南 » iOS编程基础:Swift、Xcode和Cocoa入门指南全文在线阅读

《iOS编程基础:Swift、Xcode和Cocoa入门指南》8.1 文档窗口

关灯直达底部

在Xcode中,访问文档的主要途径是通过文档窗口(Window→Documentation and API Reference或Help→Documentation and API Reference,Command-Shift-0)。在文档窗口中,查看文档的主要方式是通过搜索进行的;比如,按下Command-Shift-0(如果已经在文档窗口中,那就请按下Command-L),输入NSString并回车,选择第一个结果,即NSString类参考。如果需要,可以单击放大镜图标将结果限定在iOS相关的文档集中。

在文档窗口中有两种方式可以查看搜索结果:

弹出结果窗口

如果不断在搜索框中输入,那么会有很多结果列在弹出窗口中。使用鼠标单击,或通过箭头键导航,然后按下回车键,指定想要查看的结果。如果搜索框获得了焦点,那么还可以通过按下Esc键弹出或隐藏这个弹出窗口。

完整的结果页面

如果搜索框获得了焦点,但弹出结果窗口没有出现,那么可以按下回车键查看列出了所有搜索结果的页面;这些结果会根据类别列在4个单独的页面中,类别分别是API参考、SDK指南、工具指南与示例代码。

还可以从代码中进行文档窗口搜索。你会经常这么做:你想在代码中直接查看用到的某个符号(类名、方法名或属性名等),并且想了解关于它的更多信息。按住Option键并将鼠标悬浮在代码中的某个符号上,直到出现一个蓝色的点状下划线;接下来(依然要按下Option键),双击该符号。这会打开文档窗口,你会直接进入类文档页面中对该术语的解释部分,或完整的搜索结果页面中。

(与之类似,第9章将会介绍的代码完成过程中,可以单击More链接完成相同的事情,直接跳转到当前符号对应的文档中。)

此外,可以在代码中(或其他地方)选定一段文本,然后选择Help→Search Documentation for Selected Text(Command-Option-Control-/)。这相当于在文档窗口的搜索框中输入该文本,然后查看完整的结果页面。

文档窗口像是一个漂亮的Web浏览器,因为文档本质上包含的是网页。多个页面可以同时出现在文档窗口的页签中。要想导航到新的页签,请在导航时按住Command键(比如,按住Command键并单击某个链接,或按住Command键并单击弹出结果窗口中所选的某项),或从上下文菜单中选择Open Link in New Tab。可以在页签之间导航(Window→Show Next Tab),每个页签都会记住其导航历史(Navigate→Go Back,或是使用窗口工具栏中的后退按钮,它也是个弹出菜单)。

可以在Web浏览器中打开当前在文档窗口中所查看的页面,方式是选择Editor→Share→Open in Browser。

文档页面可能还会带有一个相关条目列表。列表开头会显示在页面上方的窗格中;当单击“More related items”链接时,完整列表会弹出来(如图8-1所示)。比如,NSString类参考页面的相关条目窗格包含了NSString类继承与使用的协议的链接,同时在弹出层中还会显示出更多的信息与链接。本章后面将会介绍关于类相关条目的更多信息。

图8-1:UIButton类文档页的开头

文档页面可能会带有一个目录,显示在文档页面左侧的窗格中(如图8-1所示);如果没有显示,那么请选择Editor→Show Table of Contents,或单击窗口工具栏中的Table of Contents图标。比如,NSString类参考页面就有一个目录窗格,它链接到该页面中的所有主题与方法。一些文档页面会通过目录来展示页面在更大规模的页面组中的位置;比如,String编程指南就包含了多个页面,在查看一个页面时,目录窗格会列出所有的String编程指南页面以及每个页面的主题内容。

针对所有文档集(库)的完整的层次目录位于文档窗口的最左侧;如果没有显示,请选择Editor→Show Library,或单击窗口工具栏中的导航按钮。该层次目录展示了所有的参考文档,同时还有指南与示例代码,并根据主题进行分类。在查看文档页面时,要想在完整的层次目录中看到它,请选择Editor→Reveal in Library(或从上下文菜单中选择Reveal in Library)。

如果希望后面再访问某个文档页,那么可以将其标记为书签,方式是选择Editor→Share→Add Bookmark,单击工具栏中的Share按钮并选择Add Bookmark,或单击文档页左侧的书签图标(这也是最简单的方式)。书签会显示在文档窗口的左侧,在导航器中与完整的层次目录在一起;如果书签窗格没有显示出来,那么请选择Editor→Show Bookmarks。可以通过导航器顶部的图标在库窗格与书签窗格之间切换。单击书签窗格中的书签会跳转到文档窗口。书签的管理是非常简单的,同时又很有用:可以重新排列或删除书签。

要在当前的文档页中搜索文本,请使用Find菜单命令。Find→Find(Command-F)会弹出一个搜索框,就像在Safari中一样。

第三方文档查看器应用,如Dash(http://kapeli.com/dash),提供了比文档窗口更优秀的本地文档集搜索与查看功能。此外,大多数文档都可以通过Web浏览器查看,地址是http://developer.apple.com,即Apple公司的开发者站点;通过Web浏览器可以显示或隐藏页面的各个部分,它包含了对方法与属性的按照字母搜索的索引,甚至还会显示出文档窗口遗漏的信息。