如何使用.NET开发全版本支持的Outlook插件产品（三）——全面控制

飞跃111

　　插件项目所有代码都已经上传至
　　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商业应用程序。