officeba > 单独文章


上传图片——Word 2007高级应用(十)

      如果你曾经在Word 2007里设置博客帐号,那么你应该不会对下面这个对话框感到陌生:

 
图   1

        留意到Picture provider下拉列表右边有一个Refresh List超链接,这意味着列表里面的内容并非固定的,我猜Word Team应该为此留下一些扩展的余地,然而,怎样才能得知如何扩展呢?还记得我们曾经在"我的博客"侧边栏里用Documents.Open() 方法打开存档草稿吗?或许Documents类里面会有一些线索!浏览Documents类的成员方法,发现一个AddBlogDocument() 方法,它的效果相当于点击Office Button\Publish\Blog后创建的Word窗口,然而,这并非我想要找的。接着,我把Word 2007的Word Object Model Reference里的所有条目浏览一遍,还是没有发现。如果真有这个扩展机制的话,它不在Word的对象模型里,难道在Office 2007的公共部分?抱着试试看的态度,我又浏览了2007 Office Suites里的Object Model Reference,发现两个带有"Blog"字眼的接口:

IBlogExtensibility
IBlogPictureExtensibility
        难道这就是我一直在找的真命天子?赶紧Google以下,发现Andrew写了一篇文章介绍Office 2007引入用于扩展的新接口,从文中可以得知,IBlogPictureExtensibility接口确实是Picture provider的扩展点,遗憾的是,Andrew无法确定该接口是否能在VSTO Runtime上正常工作。

增值服务区
Office 2007 New Extensibility Interfaces,Andrew Whitechapel

        既然看到了希望之光,就不应该随便放弃;既然Andrew他们没有对该接口进行测试,那我就来做一下,即便最后不成功。然而,实现这个接口的对象应该放在哪里,Word 2007才能正确识别并使用其中的功能呢?

        突然,一个问题在我脑海里油然而生:同样作为扩展接口,其它接口,例如IRibbonExtensibility,又是如何被Word 2007识别的呢?由于Visual Studio 2008 Beta 2自带的VSTO已经把关于Ribbon的很多东西封装起来了,所以要看出它如何让实现IRibbonExtensibility的对象被Word 2007识别并不容易。此时,我想到在VSTO 2005 SE上创建Ribbon时,IRibbonExtensibility还是"可见"的,于是找了个代码来看看:

 

        真相终于大白了,原来它是通过AddIn.ReguestService() 方法做到的!下面,我们来做第一个吃螃蟹的人。

 

着手实现

        首先,添加一个CnblogsPictureProvider类,并让它实现IBlogPictureExtensibility接口:

 

        接着,在BlogPictureProviderProperties() 方法里添加如下代码:

 

        然后,在项目里添加如下所示的窗口:

 

        其中,Provider下拉列表的数据源来自PictureProviders.xml文件:

 

        这样,你便可以通过配置文件让CnblogsPictureProvider支持博客园旗下的所有子站。而用户添加的图片上传帐号则储存在PictureAccounts.xml文件里:

 

        其中,blogaccount是使用该图片上传帐号的博客ID,它是一个有Word 2007在设置博客时自动生成的GUID;serviceurl是urltemplate和username组合之后的url,这也是博客园的组合规则。由于这里涉及到敏感信息,你应该对它们进行加密处理。

        这两个文件将会和Blogs.xml放在同一目录里。当Picture Account对话框显示时,将会加载PictureProviders.xml里面的数据并显示在Providers下拉列表里:

 

        当用户点击OK时,我们需要对数据进行验证,并把数据存到PictureAccounts.xml里面。目前,我们只是简单验证两个编辑框是否为空,而错误信息将通过ErrorProvider显示。

 

        Picture Account对话框是在CreatePictureAccount() 方法里调用的:

 

        现在轮到PublishPicture() 方法了,它的工作就是从PictureAccounts.xml文件里面读取所需数据,然后调用博客园的MetaWeblog API上传图片。然而,当我正要着手实现该方法时,出现了一个让我一筹莫展的问题:Image参数究竟是什么?如果无法得知它的具体类型,恐怕这条路是走不下去了。它会不会是某种COM的图片类型呢?突然,我脑海里闪出Andrew的一篇关于图片转换的文章,里面提到基于COM的IPictureDisp和System.Drawing.Image之间的转换,于是尝试把Image转换成IPictureDisp,异常!用Reflector查看该接口,发现它打上了 [MarshalAs(UnmanagedType.IUnknown)]。再想想,这是一个关于COM和.NET之间传递数据的问题,有没有可能在Marshaling的相关主题中找到线索呢?从MSDN到Google找了很久,未果,于是向众多MS的人发邮件请教,并在MSDN论坛发帖子,未有音信。每个COM接口都会有一个GUID,有没有可能从这个入手进一步了解PublishPicture() 呢?通过元数据获得IBlogPictureExtensibility接口的GUID,然后搜索注册表,发现该接口的Key和另一个GUID,搜索那个GUID,发现"PSOAInterface"字眼,于是Google一下,发现Dinesh Ahuja的一篇关于Marshaling的文章,其中就提及到Type Library Marshaling。再次Google,发现此内容在《Applying COM+》一书的第五章有述,从中了解到COM的Late Binding。既然Image是作为IUnknown封送的,那么它必定实现了这个接口,也必定支持这个接口的QueryInterface() 方法,顿时,一个奇怪的主意在我脑海中萌生了:通过Marshal.QueryInterface() 方法试探它到底实现了什么接口。以下是实验代码:

 

        结果是让人欣喜的,原来Image实现了IStream接口(该接口的托管定义可以在System.Runtime.InteropServices.ComTypes命名空间里找到),这样,我们就可以继续走下去了。

增值服务区
Converting between IPictureDisp and System.Drawing.Image,Andrew Whitechapel
Platform Invocation Services in .NET Framework,Dinesh Ahuja

        有了这些准备,我们就可以写一个辅助方法读取Image的数据了:

 

        需要说明的是,IStream.Stat() 方法的第二个参数可取STATFLAG枚举的任一值,我尝试给它传个0,以便获取图片名字用于稍后的上传,无奈只得一个null,只好换回1,让它无需在返回的STATSTG结构中包含pwcsName成员的值。至于图片的上传,我选择使用Cook Computing的XML-RPC.NET类库来访问博客园的MetaWeblog API。

        下载xml-rpc.net.2.1.0.zip压缩包,从中解出CookComputing.XmlRpcV2.dll和MetaWeblogAPI.cs两个文件,修改一下MetaWeblogAPI.cs中IMetaWeblog接口,使它继承自IXmlRpcProxy接口(否则后面没有办法指定MetaWeblog API的URL),接着把它们都添加到项目里,然后就可以实现PublishPicture() 方法了:

 

        现在万事俱备,只欠在ThisAddIn类中重写RequestService() 方法了:

 

 

        至此,上传图片问题的探讨要告一段落了。此时,有人可能会问,这个扩展能工作吗?是的,到目前为止,这个系列的文章都是在Word 2007上完成并发布的。虽然这个扩展还有很多地方需要完善,不过作为一个探索的手段,我想这已经足够了。开发并不是软件的全部,要使软件成功发挥作用,我们就不能忽略/忽悠部署这个环节。下一回,最终回,我们将探讨插件的部署以及其它相关的问题。

 


声明:欢迎各大网站转载本站文章,还请保留一条能直接指向本站的超级链接,谢谢!

时间:2008-01-20 17:38:33,点击:65824


【OfficeBa论坛】:阅读本文时遇到了什么问题,可以到论坛进行交流!Excel专家邮件:342327115@qq.com(大家在Excel使用中遇到什么问题,可以咨询此邮箱)。

【声明】:以上文章或资料除注明为Office自创或编辑整理外,均为各方收集或网友推荐所得。其中摘录的内容以共享、研究为目的,不存在任何商业考虑。如有任何异议,请与本站联系,本站确认后将立即撤下。谢谢您的支持与理解!


相关评论

我要评论

评论内容