用DELPHI开发AUTHORWARE的u32
函数功能是AUTHORWARE最突出的特征,利用AUTHORWARE提供的系统函数能够完成一些复杂的控制任务。对于一些特殊的任务,AUTHORWARE允许用户自己定义函数,使得程序设计具有更大的灵活性。对于windows系统来说,自定义函数是以动态链接库(DLL)文件存储的,因此存储自定义函数的文件与当前交互式应用程序文件是分立。本文介绍一下如何用DELPHI开发AUTHORWARE的自定义函数—32 bit U32,本文以DELPHI开发可在AUTHORWARE中调用显示message box的U32为例子。虽然AUTHORWARE ATTAIN 5.0已提供了使用knowledge objects 显示message box的功能,但在4.0以前的版本无此功能,这就可用其它语言开发自己的U32,在AUTHORWARE中调用。
开发U32可分为五个步骤:
创建工程文件
创建函数
创建资源文件
编译资源文件
创建u32
1.创建工程文件
在file/new选择dll生成一个dll文件,在file/add to project….加入一个包含U32函数代码的单元myunit.pas(此单元在第二步创建函数中详细说明)在uses后必须声明所有可在authorware中调用的函数。例如:
exports MsgBox;
最终的代码如下所似:
library authorware;
uses
SysUtils,Classes,
myunit in 'myunit.pas';
exports MsgBox;
begin
end.
2.创建函数
当你创建一个函数可用在authorware中,必须声明为exported 函数在关键字interface 后面加入代码如下:
interface
uses ,Dialogs,SysUtils,windows;
function MsgBox(msg:string;mbType:
Word;title:string):WORD;export;
Delphi32 需要添加{$ifdef WIN32} stdcall ;
($endif} 在函数声明后面如:
function MsgBox(msg:string;mbType:
Word;title:string):WORD;export;
{$ifdef WIN32} stdcall ; {$endif}
现在我们为函数加入代码在implementation后面:
const
OKOnly=0;
OKCancel=1;
AbortRetryIgnore=2;
YesNoCancel=3;
YesNo=4;
RetryCancel=5;
Critical=16;
Question=32;
Excalamation=48;
Information=64;
DefaultButton1=0;
DefaultButton2=256;
DefaultButton3=512;
ApplicationModal=0;
SystemModal=4096;
function StrToPch(Str:string):PChar;
var a:PChar;
begin
a:=StrAlloc(Length(Str)+1);
StrPCopy(a,Str);
StrToPch:=a;
end;
function MsgBox(msg:string;mbType:
Word;title:string):WORD;
VAR
LpText,lpCaption:Pchar;
h:HWND;
begin
lpText:=StrToPch(title);
lpCaption:=StrToPch(msg);
h:=GetActiveWindow();
MsgBox:=MessageBox(h,lpText,lpCaption,mbType);
end;
3.创建资源文件
最后我们要做的事情是创建资源文件,这样authorware才能直接调用函数。必须先创建.rc文件然后编译成.res文件。使用记事本创建.rc的资源文件。加入如下定义:我将在后面解释这些定义:
1 DLL_HEADER PRELOAD DISCARDABLE
BEGIN
"MsgBox\0",
"\0"
END
msgbox DLL_HEADER PRELOAD DISCARDABLE
BEGIN
"\0",
"W\0",
"SWS\0",
"Result := MsgBox(msg,mbType,title)\r\n",
"\r\n",
"show messagebox\0",
END
如果一个 dll文件是按authorware调用转换格式编写,则存储于其中的所有自定义函数的目录也包含在该文件中,并且authorware在调用这些函数时所需的信息也包含在内,其目录称为目录源,而且目录源中的每一个函数有相应的定义,这些定义称为定义源。具体格式如下:
1. 目录源
目录源的格式如下所示:
| DLL_HEADER PRELOAD DISCARDABLE
BEGIN
“functionname [=exportname]\0”,
“functionname [=exportname]\0”,
….
“functionname [=exportname]\0”,
“\0”
END
① | 是目录源标识符;
② DLL_HEADER 是用于创建描述性文字的起始标记;
③ BEGIN 表示该目录源文件的开始,
而END则表示该目录源的结尾。
2.自定义函数的定义格式
对于目录源中每一函数都要有一个相应的定义格式,具体格式如下所示:
functionname DLL_HEADER PRELOAD DISCARDABLE
BEGIN
“dllfilename\0”
“returnvalue\0”
“argumentlist\0”
“description>”,
“description”,
…
“description\0”
END
① functionname 指的是在目录源中以定义的函数名;
② DLL filename 表示存储函数的dll文件名;
③ Returnvalue 表示该函数返回值类型;
④ Argumentlist 表示该函数中的参数类型列表;
⑤ Description 表示该函数描述性正文。
描述性正文可以有很多行组成,但最后一行必须加上“\0”结束符。
3.参数类型描述格式
参数类型用一个大写字母表示,每一个字母表示一个参数格式,如下表所示:
描述格式 类型 描述格式 类型
C Signed char P Far pointer
B Unsigned char F Float
I Signed short integer D Double
W Unsignedshort integer S Handle
L Signed long integer V Void
U Unsigned long integer
4.编译资源文件
把.rc的资源文件保存为a3w.rc(注意不能保存文件名与dll文件名相同否则delphi自己的资源文件会覆盖它),delphi自带的编译文件为brc32.exe,在dos模式下运行:
c:\delphi32\bin\brc32 -r a3w.rc –foa3w32.res
现在把资源文件加入工程中,返回delphi在view/projcet source打开工程文件在
exports MsgBox;后可看到:
{$R *.RES}
删除该行加入: {$ifdef WIN32}
{$R a3w32.res}
{$else}
{$R a3w16.res}
{$endif}
编译工程文件.
5.创建u32
我们已经创建了32bit的authorware.dll,把它改名成authorware.u32.现在已成功创建了U32.在authorware中调用authorware.u32在运算设计按钮添加代码:
MsgBox("警告框",1+32+0+4096,"是否退出本系统?")