Word2000/XP中内部COM插件的编程实现

编译：徐景周

下载本文示例源代码

简介
Office2000/XP中Word下的内部COM插件的实现方法和前面我的文章《 Office2000下内部COM插件的编程实现》中介绍的示例Outlook2000下内部COM插件的实现方法与步骤基本相同，在这里，我想不用再重复哆嗦大部分前面文章里已经讲过的内容了，只将重点放在它们间实现的不同点上，有兴趣的朋友可以参看前面这篇文章，然后再看这篇文章一定会事半功倍的。本文章提供的Word内部COM插件示例源码运行后的效果图如下所示：



具体实现
下面，让我们来看看它们间(Word2000 vs Outlook2000内部COM插件)的实现内容到底有什么不同呢？可以先建一个ATL工程，起名WordAddin，再插入一个简单对象，起名IWord2000Addin，其它步骤可参看前面我讲的文章中介绍的内容进行操作。在这里，除了下面介绍的源码内容需要改动处，其它部分的源码内容基本上和前面我讲的文章中的示例源码相同，一般并不需要改动(除非你有其它方面的特殊需求)。

第一点：在文件中Stdafx.h中的类型的导入部分源码将有所不同，可将源文件中源码替换为下面部分既可。

// 导入工程所需Office2K及Word2K类型库(路径可根据安装路径自行设定), jingzhou xu
/* Office XP下导入如下:  */
//#import "C:/Program Files//Common Files//Microsoft Shared//Office10//MSO.DLL" rename_namespace("Office")
//using namespace Office;

//#import "D://Program Files//Common Files//Microsoft Shared//VBA//VBA6//VBE6EXT.olb" rename_namespace("VBE6")
//using namespace VBE6;

//#import "D:/Program Files/Microsoft Office/Office10/MSWORD.olb" rename("ExitWindows","ExitWindowsEx"),
//named_guids,rename_namespace("MSWord")
//using namespace MSWord;

/* Office 2000下导入使用 */
#import "E://Program Files//Microsoft Office//Office//mso9.dll" rename_namespace("Office")
using namespace Office;

#import "D://Program Files//Common Files//Microsoft Shared//VBA//VBA6//VBE6EXT.olb" rename_namespace("VBE6")
using namespace VBE6;

#import "E://Program Files//Microsoft Office//Office//MSWORD9.olb" rename("ExitWindows","ExitWindowsEx"),
named_guids,rename_namespace("MSWord")
using namespace MSWord;

第二点：注册类型信息有所不同(*.rgs)，如将文件Word2000Addin.rgs中内容的下半部分修改如下所示：

HKCU
{
  Software
  {
    Microsoft
    {
      Office
      {
        Word
        {
          Addins
          {
            ''WordAddin.Word2000Addin''
            {
              val FriendlyName = s ''Word2000 Addin''
              val Description = s ''Word2000 Addin''
              val LoadBehavior = d ''00000003''
              val CommandLineSafe = d ''00000001''
            }
          }
        }
      }
    }
  }
}

第三点：Word2000/XP中没有ActiveExplorer对象，所以可以不再经过它，直接从_Application中获得CommandBars对象进行操作。修改部分如下面源码所示:

// 装缷插件时处理
STDMETHOD(OnConnection)(IDispatch * Application, 
	ext_ConnectMode ConnectMode,
	IDispatch * AddInInst, 
	SAFEARRAY * * custom)
{
	CComPtr < Office::_CommandBars> spCmdBars; 

	// Word应用接口_Application
	CComQIPtr<MSWord::_Application> spApp(Application);
	ATLASSERT(spApp);
		
	// 获取CommandBars接口
	HRESULT hr = spApp->get_CommandBars(&spCmdBars);
	if(FAILED(hr))
		return hr;
	ATLASSERT(spCmdBars);
	......
	......
}

好了,Word2000/XP下和Outlook2000下的内部COM插件实现的不同点主要就这些了,具体实现的详细代码可参看两篇文章所附带示例源码，内有详细注释。

最后，我想再补充一点的是，由于Office97及其以下版本不支持内部COM插件接口(特别是IDTExtensibility2接口)，所以以上程序在Word97中并不适用。为了能在Word97下也能用，我们可以采用另一种方法：既VBA+ATL插件来实现．在用ATL编程时由于没有IDTExtensibility2接口支持，所以不能再用OnConnection()和OnDisconnection接口涵数来实现在装载插件和卸载插件时的操作。我们可以在在工程中创建两个接口涵数，如名为：Init()和Uninit()，把它们当做上面所提到的两个装载、卸载接口涵数，可以在Init()中加入实现插入工具条按钮部分，代码大致和本文示例相同，Uninit()中实现取消操作。然后可以建一Word模板(*.dot)，在其中插入VBA来实现创建并加载、卸载组件的方法，如下面VBA源码：

Dim o as Application
Dim obj as Object

Sub AutoExec()
Set obj = CreateObject("Word97Addin.Addin")
Set o = ThisDocument.Application
obj.Init o
End Sub

Sub AutoExit()
Set o = ThisDocument.Application
obj.Uninit o
Set obj = Nothing
Set o = Nothing
End Sub

由于这些并不是本篇文章的重点（重点是实现Word2000/XP下内部COM插件），所以，在这里我就不必再详细讨论了，有兴趣的读者可以参考其它相关资料。

参考文献：
Office2000下内部COM插件的编程实现 -- 徐景周(译者)
Writing an MS Word addin -- Amit Dey
ATL开发指南(第二版) -- Tom Armstrong & Ron Patton