前言 每当我在文章中提到.NET Framework的某个类、属性或者方法时,我会为它添加一个超链接,引用.NET Framework Class Library的在线文档。首先,我用浏览器打开MSDN Library的页面,接着,在左边的导航目录树中定位到对应的节点,然后,把该节点的超链接复制下来,最后回到 word2007 中插入这个超链接。然而,我已经对这个繁琐的过程感到厌倦了,是否有办法把.NET Framework Class Library的在线文档集成到 Word 2007 中,从而让这个过程变得更加简单呢?
需求 X 需求
下图是用Paint.NET弄出来的示意图:
图 1
我希望把MSDN Library上.NET Framework Class Library那部分导航目录树以侧边栏的方式集成到word 2007里,这样,当我右击某个节点,点击Insert菜单项时,将在当前文档的光标处插入该节点对应的连接。
作为用户,我提出了上面这些需求,那么,作为开发人员,为了实现这项功能,我又该提出哪些"需求"呢?
首先,我需要MSDN提供访问这些数据的服务,没有这个服务,实现这项功能就非常困难,甚至变得不可能。幸亏,MSDN的确提供了这样一个服务,它叫MTPS(MSDN/TechNet Publishing System)Content Service(以下简称"MPTS")。这样,实现这项功能的首要任务就是学习使用这个服务了。这里将会用到Craig Andera在其文章上所提到的知识和技巧(见下表)。
其次,我需要知道如何为word 2007创建侧边栏以及为这个插件在Ribbon上添加一个启动按钮。这里将会用到《探索 Word 2007 开发(一):我的博客》、《探索 Word 2007 开发(三):管理侧栏》和《探索 Word 2007 开发(二):扩展 Ribbon》三篇文章的研究成果。
再次,我需要知道TreeView这个控件的使用方法和技巧。这里将会用到《TreeView 四技》这篇文章的研究成果。
最后,我需要知道如何在Word 2007中插入超链接。
多重影分身术
多重影分身术是一种实体复制忍术,如果你看过《火影忍者》,应该能够理解它的意思。现在我要做的和这个差不多,为MSDN Library的.NET Framework Class Library导航目录树产生出多个实体分身,并把它们嵌入 word 2007 里,不同的是,多重影分身术是由本体实施,而这里的实体复制是由身为第三方的我来实施。
本节的焦点是用MTPS返回的数据填充侧边栏里的TreeView控件。下面是这个插件的需求列表:
一开始,TreeView里面只有一个顶节点——.NET Framework Class Library,且该节点是折叠的。
使用延迟填充技术,每个可展开节点会且只会在第一次展开时访问MTPS获取数据,并填充子节点。
这两个需求看起来很简单,然而,一旦和MTPS 结合使用就比较复杂了,你需要区分MPTS所使用的两套标识系统,一套是用于标识节点的导航的,另一套是用于标识节点所指向的内容的。如果你还没接触过MTPS,那么我强烈建议你先阅读Craig Andera的两篇文章,否则你有可能无法理解后面的内容。这里我做一个简单的介绍,MTPS有两种节点:导航节点和内容节点,导航节点与MSDN Library/TechNet Library左侧的导航目录树中的节点一一对应;内容节点则是与该导航节点对应的用于显示在右侧的内容。这两种节点使用了同一种标识模型,每一个标识包含了三个部分:标识符、区域信息和版本信息。其中标识符又分五种类型:short ID、content alias、content GUID、content URL和asset ID。并非所有节点都同时具备这五种标识符,也并非所有情况下MTPS都返回/接受这五种标识符,于是,如果你需要在不同的标识符之间切换,你可能需要再次访问MTPS。有鉴于此,上述两个需求的复杂性主要体现在处理不同种类的节点以及用于标识这些节点的不同种类的标识符上。