在Word中嵌入应用程序

在Word中嵌入应用程序

在Word中嵌入应用程序

2001-09-19· ·鲁松 张梅 ··vbeden

Microsoft Word以其强大的文字处理能力、灵活多变的排版方法、所见即所得以及友好的用户界面等特点,博得了广大用户的肯定。但是,若能将其他一些功能,如机器翻译、中文校对、全文检索、实时语音合成等嵌入其中,则可以扩展Word的功能,使开发者能够更加充分地利用Word资源,加快开发速度。

开发Word应用程序常用的有以下几种编程语言:Word Basic、VBA(Visual Basic for Applications)和Word API。 尽管Word Basic和VBA功能强大,但作为简单修改Word的工具,多少有些大材小用。笔者认为,Word API是开发Word应用程序的首选工具,尤其是可以利用C语言代码的快速、高效和灵活的特点,而且可以使用Word Basic接口函数和Windows动态连接库编程环境,实现对Word功能的添加。

Word API的使用方法

Word API生成的是一个可在Word中直接运行的Word加载项,它是一个以WLL为扩展文件名的单机动态连接库。这种WLL是标准的Windows动态连接库的特殊形式。可以用任何一个创建Windows DLL的环境来编译、链接和建立WLL。

Microsoft Word Developer's Kit(MS Word开发工具箱)中,提供了Word API的接口函数,下面分别加以介绍。

1. Word加载项的启动和卸载函数

(1) void FAR PASCAL wdAutoOpen(short DocID)

在Word中加载WLL的同时,Word会自动执行这个函数。在执行过程中,函数wdAutoOpen完成以下几个任务:

·向Word登记WLL中定义的所有函数;

·将WLL中的操作命令添加到Word的主菜单、快捷菜单和工具条中;

·给WLL的操作命令指定快捷键;

·完成WLL功能的初始化(如:机器翻译、中文校对的词库读入等)。

(2) void FAR PASCAL wdAutoRemove(void)

当WLL被卸载时,如果WLL程序中定义了wdAutoRemove(void)函数,Word将在卸载时执行这个函数。在该函数中,可以保存退出时我们定义功能函数生成的必要数据。

. Word加载项中的登记函数

要想让Word中的某个主菜单项、快捷菜单项、工具条按钮或快捷键完成我们定义的某个函数,就必须在加载WLL时,先向Word登记我们的应用函数。Word API的接口函数CAPIRigister可以完成登记任务。该函数定义形式如下:

3. 在Word中将加载函数添加到主菜单项、快捷菜单项、工具条按钮和快捷键中 在WLL中应用函数登记完成之后,就可以在主菜单、快捷菜单和工具条中添加自己的菜单项和快捷键。这些工作由下面的函数完成

在Word中嵌入应用程序

*S在Word中添加新的工具条:

·在菜单项中添加新的菜单命令:

要想定义组合键的快捷键方式,就需把几个键在Word Basic中的代码数字的二进制进行按位‘或’运算,将结果传递给第二个参数KeyCode。例如:快捷键CTRL+S的KeyCode是(256 OR 83)=339。

4. Word API调用Word Basic函数前,函数参数和返回值的数据缓冲区的建立Word中的所有字处理功能都可由对应的Word Basic函数来实现。正是利用这一点,在

WLL中可以通过调用Word Basic函数来实现对Word的定制。因此,必须利用Word API函数InitWCB设立调用Word Basic函数时传递参数与返回值的数据缓冲区。

InitWCB的参数说明如下:

例如,下面这段程序是获取所选区域的字符串字体情况:

WCB wcb; file://Word的参数和返回值传递的数据区

short isbold;

InitWCB(&wcb,TypeShort,NULL,0);

file://设立传递Word Basic函数参数和返回值的数据区wcb

WORDFUNCTION(wdBold);

file://调用Word Basic函数Bold()

isbold=wcb.wdoprReturn.Short;

file://从数据区wcb中取出Word Basic函数Bold()的返回值

5. Word Basic函数调用方法

Word中的命令是与Word Basic函数一一对应的。因此,Word API可以通过接口函数用C语言直接调用Word Basic函数来实现Word命令。

注意:在Word API中调用Word Basic命令函数名时均须在Word Basic函数名前加上2个英文字母‘wd’,如:Word Basic函数Bold在Word API中的函数名应为wdBold。 根据这些函数有无返回值与是否为响应对话框的情况,在Word API头文件

在Word中嵌入应用程序

basedef.h定义了三种调用方法:WORDCALL、WORDFUCTION和WORDDIALOG。 ·若被调用的Word Basic函数无返回值,用Word API接口函数WORDCALL来调用,形式是:WORDCALL(函数名);

· 若被调用的Word Basic函数有返回值,用Word API接口函数WORDFUNCTION来调用,形式是:WORDFUNCTION(函数名);

·若被调用的Word Basic函数是有关对话框操作,用Word API函数WORDDIALOG来调用,形式是:WORDDIALOG(函数名)。

例如:Word Basic中,给所选区域字符标粗体的函数Bold与判断所选区域字符是否为粗体的函数Bold()的调用方法就不同:

·函数Bold是一个操作,无须返回值,所以调用形式是WORDCALL(wdBld)。

·函数Bold()是一个判断,必须有返回值,所以调用形式是WORDFUNCTION(wdBold);

6. Word Basic函数参数的传递方法

在调用Word Basic带参函数时,需要通过Word API特定接口函数来传递参数。同时,对不同类型的函数,参数的传递方法也不同。

(1) 逐个传递参数

这种传递参数的方法适用于参数位置固定的函数,例如:Word Basic函数: MenuText$(Type,MenuNumber[,Context])

其中的三个参数是按次序排列的。由于Word API调用Word Basic函数方式是函数名作为WORDCALL、WORDFUCTION和WORDDIALOG的参数,无法一次添加Word Basic函数参数,所以传递Word Basic函数参数时需要在InitWCB函数设置数据缓冲区后,依次通过数据缓冲区传递参数,第一个赋给Type,第二个赋给MenuNumber,如果有第三个参数则赋给Context。

在向这类函数传递参数时,根据待传递参数数据类型的不同,有以下4个函数可以选用

·传递short型参数的函数:

·传递long型参数的函数:

·传递字符串参数的函数:

在Word中嵌入应用程序

这种传递参数的方法适用于参数有标识名指明的函数。这种函数的参数有定义了的标识,传递时没有次序问题。例如:Word Basic中插入空表的函数TableInsertTable: Ta

因此,向TableInserTable函数传递参数时,只需指明哪一个标识即可。这种情况一般用于具有较多参数的函数。

在向这类函数传递参数时,与上面的类似,也是根据参数数据类型的不同,有以下4个函数可以选用:

下面的例子是要在光标所在位置插入一个4*12的空表:

标识名。调用函数AddString DlgField,将表的行数"4"和列数"12"直接传给Word Basic的函数TableInsertTable的两个参数NumColumns和NumRows。

注意:在Word API文件wdfid.h中被定义了的函数参数的标识名是与Word Basic函数的参数标识名一一对应的,但不同的是,Word API的参数标识名是在WordBasic的参数标识名前加了‘fid’构成的。如:Word Basic的函数TableInsertTable有两个参数是NumColumns和NumRows,那么,在Word API中的参数标识名就应是fidNumColumns和fidNumRows。

创建WLL的程序框架

本文给出一个用Word API完成的完整WLL框架,来实现如下图所示Word中的修改。

在Word中加载或卸载WLL

经过编译、链接生成DLL文件(动态连接库文件)后,必须将文件的扩展文件名.dll改为.wll,以便在加载WLL时能被Word正确识别为Word加载项。

将自己编写的WLL加载到Word中有以下几种方法:

·模板方式加载:在Word中主菜单‘文件’中找到‘模板’,进去后按下‘添加’按钮,选中自己编写的WLL模板文件(文件扩展名为wll)后‘确定’,加载WLL即可完成。 ·打开文件方式加载:像打开一般的Word文档一样,打开WLL模板文件,即可完成

在Word中嵌入应用程序

加载 。

·Word自动完成加载:将WLL模板文件复制..\windord\startup\目录下,像Word中的常用模板一样,在启动Word时,Word会自动将WLL模板文件加载到Word中。

卸载WLL的方法只有一种:在Word中主菜单‘文件’中找到‘模板’,将‘共用模板及加载项’框中‘translate.wll’前的复选钮钩掉后‘确定’,卸载WLL的工作即可完成。

本文来源：https://www.bwwdw.com/article/9e31.html