如何使用.NET开发全版本支持的Outlook插件产品（三）——全面控制
插件项目所有代码都已经上传至
https://github.com/VanPan/TestOutlookAdding
进阶基础——COM查看
首先，对于Outlook对象模型，MSDN早就有非常详细的介绍，请直接查阅下面的链接：
http://msdn.microsoft.com/zh-cn/library/ms268893(VS.80).aspx
但是，对于我们在开发过程中，仅仅靠这个模型概念是完全不够的，因为如果真的开始调试，当我们获取到COM组件对象时，我们通过调试会发现所有的COM对象的类型都是“System.__ComObject”。根本无法知道这个对象的实际类型，也无从得知其中的属性和方法了。
幸好，我们有下面的这个工具类
using System; using System.Runtime.InteropServices; namespace TestOutlookAddin { public class ComHelper { /// <summary> /// Returns a string value representing the type name of the specified COM object. /// </summary> /// <param name="comObj">A COM object the type name of which to return.</param> /// <returns>A string containing the type name.</returns> public static string GetTypeName(object comObj) { if (comObj == null) return String.Empty; if (!Marshal.IsComObject(comObj)) //The specified object is not a COM object return String.Empty; IDispatch dispatch = comObj as IDispatch; if (dispatch == null) //The specified COM object doesn't support getting type information return String.Empty; System.Runtime.InteropServices.ComTypes.ITypeInfo typeInfo = null; try { try { // obtain the ITypeInfo interface from the object dispatch.GetTypeInfo(0, 0, out typeInfo); } catch (Exception ex) { //Cannot get the ITypeInfo interface for the specified COM object return String.Empty; } string typeName = ""; string documentation, helpFile; int helpContext = -1; try { //retrieves the documentation string for the specified type description typeInfo.GetDocumentation(-1, out typeName, out documentation, out helpContext, out helpFile); } catch (Exception ex) { // Cannot extract ITypeInfo information return String.Empty; } return typeName; } catch (Exception ex) { // Unexpected error return String.Empty; } finally { if (typeInfo != null) Marshal.ReleaseComObject(typeInfo); } } } /// <summary> /// Exposes objects, methods and properties to programming tools and other /// applications that support Automation. /// </summary> [ComImport()] [Guid("00020400-0000-0000-C000-000000000046")] [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)] interface IDispatch { [PreserveSig] int GetTypeInfoCount(out int Count); [PreserveSig] int GetTypeInfo( [MarshalAs(UnmanagedType.U4)] int iTInfo, [MarshalAs(UnmanagedType.U4)] int lcid, out System.Runtime.InteropServices.ComTypes.ITypeInfo typeInfo); [PreserveSig] int GetIDsOfNames( ref Guid riid, [MarshalAs(UnmanagedType.LPArray, ArraySubType = UnmanagedType.LPWStr)] string[] rgsNames, int cNames, int lcid, [MarshalAs(UnmanagedType.LPArray)] int[] rgDispId); [PreserveSig] int Invoke( int dispIdMember, ref Guid riid, uint lcid, ushort wFlags, ref System.Runtime.InteropServices.ComTypes.DISPPARAMS pDispParams, out object pVarResult, ref System.Runtime.InteropServices.ComTypes.EXCEPINFO pExcepInfo, IntPtr[] pArgErr); } }
使用的时候，只需要如下调用，就可以得到真实类型的string了，对于调试和确定真实类型时非常方便。
object selection = ExcelApp.Selection; if (selection != null) { string typeName = ComHelper.GetTypeName(selection); Debug.Print(typeName); Marshal.ReleaseComObject(selection); }
全面控制——嵌入
我们现在已经成功把Ribbon和经典工具栏嵌入到各个版本的Outlook中了，那我们还能用插件做些什么工作呢？
看看下面的截图
所有截图中的红色区域，都是可以由插件注入的，区域有上下左右以及浮动一共5种，这些区域称为TaskPanes。
需要注意的是：TaskPanes是从Office 2007版本才开始支持的，Office 2003是没有这种区域注入的。2003有一套自己的解决方案，但是可惜的是NetOffice不支持这种技术。但是我们可以针对2003用另外一个方案解决，比如弹出一个和侧边栏类似的窗体，虽然不能完全嵌入在Outlook里面，但是总可以解决2003用户的需求，毕竟现在还用2003版本的用户数量总是越来越少了，没必要为了一个过气旧版本花这么多精力。
好了，我们来看看代码吧
private void Addin_OnConnection(object app, ext_ConnectMode ConnectMode, object AddInInst, ref Array custom) { try { _outlookApplication = new OutLook.Application(null, app); TaskPanes.Add(typeof(TaskPaneContainerControl), "侧边栏标题"); TaskPanes[0].DockPosition = MsoCTPDockPosition.msoCTPDockPositionBottom; TaskPanes[0].DockPositionRestrict = MsoCTPDockPositionRestrict.msoCTPDockPositionRestrictNoChange; TaskPanes[0].Height = 100; TaskPanes[0].Visible = true; TaskPanes[0].Arguments = new object[] { this }; } catch (Exception exception) { // 处理 } }
非常简单，对OnConnection事件订阅处理，并且加入以上逻辑，即可加入一个侧边栏。
对于侧边栏的代码，还是有些小技巧，因为侧边栏只支持WinForm版本，也就是.NET 2.0版本的UserControl。可是现如今我们都在用WPF，不得不说，WPF做UI真是非常高效快捷，如果还在用Winform的各位，我很诚恳得推荐大家开始转入WPF的阵营。
回到正题，我们现在添加的是TaskPaneContainerControl，这是一个.NET 2.0的UserControl，但是内部我们可以这样做
public TaskPaneContainerControl() { InitializeComponent(); Controls.Add(new ElementHost { Child = new UserControlWpf(), Dock = DockStyle.Fill }); }
用ElementHost，我们就可以在其中塞入一个WPF的UserControl了。
添加了侧边栏以后，大家可以看到侧边栏是可以关闭的，Outlook是不会提供打开按钮的，所以我们需要在工具栏中加入一些按钮来重新打开侧边栏，这点不再赘述。
写在Outlook插件开发的最后
写到这儿，我想我们已经进入Outlook插件开发的一些核心区域了。之前的一些进入门槛的方法，也就已经全部涵盖了。我的功能也就涉及到这些区域，其它的，出于种种原因，都无法再详细描述，大家完全可以去查阅MSDN，对各种Outlook的对象进行更多的了解和开发。但是我可以提前告诉大家，以我现在所知的范围，Outlook插件最起码可以做以下功能：
- 获取当前选中的Outlook Item的所有信息，包括：邮件、联系人、日历项、活动、会议等等
- 当Outlook Item被激活时触发的事件监听
- 修改Outlook Item各项窗体，在其中注入自定义区域
- 添加、修改、删除各项Outlook Item，包括：文件夹、邮件、联系人、日历项、活动、会议等等
下面，我很迫不及待得想要向大家介绍近段时间做了大量工作，并且有完整的、非常稳定的、甚至商业可用的打包框架Wix的进阶使用场景。
我们将从安装这个Outlook插件开始，到如何打包部署一个完整的.NET商业应用程序。
