引用Amazon图书信息2 ——Word2007高级应用（十八）

列举经典

不知不觉又到设计UI的时候了，由于UI的设计与用户的操作息息相关，于是我们得先看看用户希望怎么操作这个插件：

点击Ribbon上的Amazon Book按钮打开搜索图书的窗口；
输入搜索关键字，并点击搜索；
在搜索结果中选择想要引用的图书；
插入选中图书的超链接。
此外，我们还需要进一步细化搜索结果的那些数据将显示在搜索图书窗口里：

图书的封面；
图书的完整标题；
图书的作者列表。
有了上面这些准备，我们就可以设计搜索图书窗口了。首先，在项目里添加如下所示的窗口：

图   1 - Search Book Window

这个窗口是使用Component Factory的Krypton Toolkit控件包开发的，里面包含：

给用户输入书名的编辑框；
执行搜索的按钮（Go按钮）；
显示搜索结果的ListView控件；
显示选定图书的书名的Label控件；
显示选定图书的作者的Label控件；
插入选定图书的超链接的按钮（Link按钮）；
关闭窗口的按钮（Close按钮）。
一开始，用户没有在编辑框输入任何东西，而ListView控件也没有显示任何结果，Go按钮和Link按钮应该是屏蔽状态（disable）的。当用户在编辑框了输入了东西，Go按钮会被激活：

Code 1 - Enable/Disable Go Button

同理，Link按钮也会在用户选定某本图书后激活：

Code 2 - Enable/Disable Link Button

当用户点击Go按钮时，将执行下列操作：

通过BookSearch.Search方法获取搜索结果；
构建用于ListView显示图书封面的ImageList对象；
向ListView填充搜索结果。
对于第二步，我们需要ImageManager的帮忙：

Code 3 - ImageManager

有了它，Go按钮就可以完成它的任务了：

Code 4 - EventHandler for Click Event of Go Button

ListView是一个不错的东西，但它不能单独为每个项指定图标，这是我最讨厌的。另外，你也可以对图片进行本地缓存，并让ImageManager在获取图片的时候先查看本地缓存，没有的话再去Amazon.com那里要。

当用户选定某本图书时，我们需要把它的书名和作者显示在ListView下面的两个Label上，于是我把ListView的SelectedIndexChanged事件委托修改了一下：

Code 5 - EventHandler for SelectedIndexChanged Event of ListView

回到Ribbon的设计上，我们需要一个按钮来打开搜索图书窗口，为此，我在Ribbon上添加了一个SplitButton，之所以选择它而不是普通的Button，乃因我脑海里一个突如其来的想法，稍后将会为你剖析这个想法的来龙去脉。添加了SplitButton后的Ribbon如下图所示：

图   2 - Amazon Book SplitButton on Ribbon

然后实现SplitButton的Click事件委托：

Code 6 - EventHandler for Click Event of Amazon Book SplitButton

好了，运行插件看看效果：

图   3 - Oops! The Value of ImageUrl is null

噢，抛了一个ArgumentNullException异常！还记得我是怎么处理ImageUrl吗？在Code 5里，当Amazon Web Service返回的搜索结果里面某本图书没有图片时，BookSearch.GetImageUrl方法返回null，类似地，ImageManager.GetImage方法也应该在遇到这种情况时返回一个"占位图片"：

Code 7 - New Version of GetImage Method

再次运行插件，可以看到预期的效果了：

图   4 - Search Results

连接经典

终于轮到本回的主角出场了，当用户点击搜索图书窗口的Link按钮时将在当前文档的光标处插入选定图书的超链接：

Code 8 - EventHandler for Click Event of Link Button

虽然我现在可以通过搜索图书窗口插入图书的超链接，然而在大多数时候我更愿意遵循以下步骤插入图书的超链接：

在文档的某个位置输入要插入超链接的图书的书名；
选中这个书名，使之处于高亮（highlight）状态；
点击Ribbon上的Amazon Book按钮打开搜索图书的窗口，此时，这个书名显示在编辑框里，而搜索结果则显示在ListView里，并且第一本书处于选中状态；
如果选定的图书不是我要找的，则在搜索结果里重新选择；
点击Link按钮插入选定的图书的超链接。
为此，我需要为搜索窗口添加Load事件委托：

Code 9 - EventHandler for Load Event of BookSearchView

由于搜索窗口的Load事件委托和Go按钮的Click事件委托都需要执行搜索操作和向ListView填充搜索结果，所以我把这部分代码提取出来以便重用，这样Go按钮的Click事件委托就可以简化为：

Code 10 - New Version of Click EventHandler for Go Button

此时，当我点击Link按钮，原先选中的那个书名将被替换成从Amazon.com获取的完成的书名以及作者的名字，但我希望在原先选中的那个书名的基础上插入超链接并追加作者的名字，于是，我把Link按钮的Click事件委托里为textToDisplay变量赋值的代码改成下面这样：

Code 11 - Assignment to textToDisplay Variable

幸运经典

还记得在设计Ribbon的时候把Amazon Book按钮设为SplitButton而非普通的Button吗？之所以这样做，是因为我希望为这个插件添加一个比较特别的功能，类似于Google的"手气不错"（I'm Feeling Lucky）。我为Amazon Book按钮的下拉菜单添加了两个（普通）按钮，一个是Amazon Book按钮，另一个是Lucky Book按钮，运行起来像这样：

图   5 - Lucky Book

其中，下拉菜单里的Amazon Book按钮的效果和Amazon Book主按钮一样，而Lucky Book按钮的效果则和Google的"手气不错"相似。当我在文档的某个位置输入要插入超链接的图书的书名，选中这个书名并点击Lucky Book按钮时，它将会执行基于这个书名的搜索，并插入搜索结果中第一本书的超链接。如果用户在没有选中任何文字的情况下点击Lucky Book按钮或者搜不到指定的图书，则告知用户相关信息。

Code 12 - Insert Lucky Book

至此，Amazon Book插件的开发要告一段落了，虽然我还想实现更加完善的图片管理功能，虽然我还想提供更加丰富的搜索方式，虽然我还想通过配置让插件变得更加灵活，虽然……