文件名称:outlook addin
文件大小:378KB
文件格式:7Z
更新时间:2011-05-19 03:38:53
addin changelog
Outlook 2003 addin
赵果(apple) 2008年3月7日星期五
摘要:
目前随着蓝牙、红外通信的不断发展,同步协议的应用变得越来越广泛。而同步引擎需要修改日志changelog的协助。本文的目的是记录用户对outlook2003联系人的操作日志,供同步引擎使用。
Outlook 2003 addin属于microsoft office com中的应用。目的是用于捕捉outlook2003 联系人(contacts)的增加、删除、修改的消息。
关键词:同步, changelog
工程介绍:
office com插件必须实现IDTExtensibility2接口。所有继承于IDTExtensibili ty2接口的COM插件必须实现5个方法:OnConnection,OnDisconnection,OnAddinUpdate,OnBeginShutDown,OnStartupComplete
1. 建立addin工程
(1) 启动VC++开发环境,新建一个工程,选择ATL COM AppWizard,为工程命名为Outlook Addin,确定。选择Dynamic Link Library完成。然后,点击菜单“插入”->“新建ATL对象”,选择“Simple Object”,命名为Addin,选择Attributes标签,选中Support ISupportErrorInfo,其他选项默认。
(2) 在新建的类上右键implement Interface->AddTypelib->Microsoft Add-in Designer-> IDTExtensibility2。如下图所示:
图1 添加outlook2003接口图示
图2 添加addin designer接口图示
图3 添加接口图示
(3) 添加注册表信息
向导实现了我们所选择的接口,并为IDTExtensibility2接口的5个方法提供了默认实现。现在,一个基本的自动化COM对象就准备好了。通过向rgs文件添加注册条目,我们就可以用Outlook来注册这个插件。打开文件OAddin.rgs,在文件末尾插入以下代码:
HKCU_Software
{
Microsoft
{
Office
{
Outlook
{
Addins
{
'OAddin.OAddin'
{
val FriendlyName = s 'SMIME Addin'
val Description = s 'ATLCOM Outlook Addin'
val LoadBehavior = d '00000003'
val CommandLineSafe = d '00000000'
}
}
}
}
}
}
}
注册条目看起来是很简单的。
1)LoadBehavior DWORD类型表明了Outlook装载COM插件的时机。我们的插件要在启动时装载,所以它的值设为3。LoadBehavior == 3 表示启动和连接时就自动运行;
• 0 = Disconnect - 不加载。
• 1 = Connected - 被加载。
• 2 = Bootload - 宿主程序启动时加载。
• 8 = DemandLoad - 需要时加载。
• 16 = ConnectFirstTime - 只在下次运行时加载一次。
2)FriendlyName: 字符串类型,插件的名称,将在相应程序的COM加载对话框中看到。
3)Description: 字符串类型,插件的描述信息。
4)CommandLineSafe: DWORD类型,命令行方式,可以设置为0x01(真)或0x00(假)。
2. 代码分析:
(1)需要向outlook注册add, modify, delete事件
A. 申明outlook events;
SINK_ENTRY_INFO( 1, __uuidof(Outlook::ItemsEvents), 0xf001, getOutlookaddItemsEvents, &OnItemAddInfo )
SINK_ENTRY_INFO( 2, __uuidof(Outlook::ItemsEvents), 0xf002, getOutlookmodifyItemsEvents, &OnItemModifyInfo )
SINK_ENTRY_INFO( 3, __uuidof(Outlook::ItemsEvents), 0xf003, getOutlookdeleteItemsEvents, &OnItemDeleteInfo )
0xf001:add 0xf002 modify 0xf003 delete
B. 在onconnection中注册事件;
outlookItem_add::DispEventAdvise( (IDispatch*)m_spItemsEvents_Add, &__uuidof(Outlook::ItemsEvents) );
C. 在ondisconnection中释放事件,也是在outlook关闭时停止捕捉消息;
(2)在outlook回调你的函数中实现changeglog功能。
Eg: void __stdcall CAddin::getOutlookaddItemsEvents( IDispatch* pdispItemsEvents )
{
CComQIPtr
}
结论:
本人文笔不好,请各大蝦不要见笑,详细还是见代码吧,但本人能够保证程序没有任何问题。
本人对office系列的产品有较深的见解,并具有浓厚的兴趣。目前在研究outlook express的事件捕捉,希望有跟我志同道合的朋友欢迎跟我联系一起分享开发的快乐。QQ:35912467
邮箱:my716917@sina.com
Hugo.zhao@mic.com.tw
电话:13458588397
【文件预览】:
outlook2003 addin.doc
outlookAddin
----outlookAddin_pcSuite.cpp(3KB)
----outlookSocketService.cpp(4KB)
----outlookAddin_pcSuite.aps(19KB)
----StdAfx.cpp(315B)
----resource.h(513B)
----outlookAddin_pcSuiteps.mk(610B)
----outlookAddin_pcSuite.dsw(563B)
----outlookAddin_pcSuite.plg(5KB)
----outlookAddin_pcSuite.def(248B)
----outlookAddin_pcSuite_i.c(1KB)
----Addin.rgs(965B)
----outlookAddin_pcSuite.ncb(889KB)
----Addin.cpp(2KB)
----outlookAddin_pcSuiteps.def(262B)
----outlookAddin_pcSuite_p.c(5KB)
----outlookAddin_pcSuite.idl(791B)
----Addin.h(7KB)
----outlookAddin_pcSuite.clw(557B)
----ReleaseMinDependency()
--------outlookAddin_pcSuite.dll(48KB)
--------outlookAddin_pcSuite.lib(2KB)
----outlookAddin_pcSuite.dsp(13KB)
----StdAfx.h(1KB)
----outlookAddin_pcSuite.tlb(2KB)
----outlookAddin_pcSuite.opt(58KB)
----outlookAddin_pcSuite.h(5KB)
----MSADDNDR.tlh(4KB)
----globalAddin.cpp(590B)
----outlookAddin_pcSuite.rc(3KB)
----dlldata.c(861B)
----outlookSocketService.h(727B)
common files
----globalFunc2outlook.cpp(2KB)
----globalFunc2outlook.h(2KB)
----defineforOutlook.h(2KB)