MCGS系统内部函数参考手册簿

《MCGS系统内部函数参考手册簿》由会员分享，可在线阅读，更多相关《MCGS系统内部函数参考手册簿（70页珍藏版）》请在装配图网上搜索。

1、wordMCGS系统内部函数MCGS内部为用户提供了一些常用的数学函数和对MCGS内部对象操作的函数。组态时，可在表达式中或用户脚本程序中直接使用这些函数。为了与其它名称相区别，系统内部函数的名称一律以“！符号开头。下面分别介绍各个函数的用途和使用方法。运行环境操作函数!CallBackSvr(DatName)函数意义：调用后台对象返回值：数值型，后台对象的值参数：DatName，对象名，数值型实例：X=！CallBackSvrX，调用后台数值型对象X注意：本函数在新版本MCGS系统内部，已经无效。为了保存与旧版本的兼容性，暂时保存。!ChangeLoopStgy(StgyName，n)函数意

2、义：改变循环策略的循环时间返回值：数值型。返回值=0：调用正常；0：调用不正常。参数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间实例：!ChangeLoopStgy(报警策略，5000)，将报警策略的循环时间改为为5秒!CloseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串WndName中指定了一个窗口，如此打开这个窗口，关闭其他窗口。如果WndName为空串，如此关闭所有窗口。返回值：数值型。返回值：=0：调用正常；0：调用不正常。参数：WndName，用户窗口名，字符型。实例：!CloseAllWindow(“工况图)，关闭除了用户窗口

3、“工况图以外的其他窗口，假如“工况图窗口没有打开，如此在关闭其他窗口的同时打开该窗口!CloseAllWindow(“)，关闭所有窗口。!EnableStgy(StgyName，n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。返回值：数值型。返回值=0：调用正常；0：调用不正常。参数：StgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。实例：!EnableStgy(报警策略，1)，打开报警策略；!EnableStgy(报警策略，0)，关闭报警策略，使报警策略无效!GetDeviceName(Index)函数意义：按设备顺序取到设备的名字。返回值：字符型。

4、调用成功返回设备名，调用失败时返回空字符串。参数：Index，数值型。实例：!GetDeviceName(0)，取0号设备构件的名称。!GetDeviceState(DevName)函数意义：按设备名查询设备的状态。返回值：数值型。=-1调用不正常。=1 设备处于正常的工作状态。=2 设备正在工作，但设备不正常。=3 设备处于停止工作状态，且设备正常。=4 设备处于停止状态，且设备有错。参数：DevName，设备名，字符型。实例：!GetDeviceState( OmronPLC)，读取设备构件“OmronPLC的当前工作状态。!GetStgyName(Index)函数意义：按运行策略的顺序获

5、得各策略块的名字。返回值：字符型。参数：Index，数值型。实例：!GetStgyName(0)，取0号运行策略的名称。!GetWindowName(Index)函数意义：按用户窗口的顺序获得用户窗口的名字。返回值：字符型。参数：Index，数值型。实例：!GetWindowName(0) ，读取0号用户窗口的名称。!GetWindowState(WndName)函数意义：按照名字取得用户窗口的状态。返回值：数值型。返回0：用户窗口处于关闭状态。返回1：用户窗口处于打开状态。返回2：用户窗口处于隐藏状态。参数：WndName，用户窗口名称，字符型。实例：!GetWindowState(工况图)

6、，获得用户窗口“工况图的状态!SetActiveX(Activename，n，str)函数意义：操作指定的动画构件，向窗口中的ActiveX控件发出控件命令返回值：无参数：Activename，字符型，控件名称，用“.“窗口0中的名为“控件1的控件。n，数值型，命令类型，请填1；str，字符型，命令字符串，具体含义请参照控件帮助。实例：!SetActiveX(“,1,start)，启动窗口0的控件0开始工作。!SetDevice(DevName，DevOp，CmdStr)函数意义：按照设备名字对设备进展操作。返回值：数值型。返回值：=0：调用正常；0：调用不正常。参数：DevName，设备名，

7、字符型；DevOp，设备操作码，数值型；CmdStr，设备命令字符串，只有当DevOp=6时CmdStr才有意义。DevOp取值X围与相应含义：1：启动设备开始工作。2：停止设备的工作使其处于停止状态。3：测试设备的工作状态。4：启动设备工作一次。5：改变设备的工作周期，CmdStr中包含新的工作周期，单位为ms。6：执行指定的设备命令，CmdStr中包含指定命令的格式。实例：!SetDevice(OmronPLC，1， )，启动设备构件“OmronPLC开始工作。!SetStgy(StgyName)函数意义：执行StgyName指定的运行策略。返回值：数值型。返回值=0：调用正常；0：调用不

8、正常。参数：StgyName，策略名，字符型。实例：!SetStgy(阀门关闭)，执行一次运行策略“阀门关闭。!SetWindow(WndName，Op)函数意义：按照名字操作用户窗口，如打开、关闭、打印。返回值：数值型。返回值：=0：调用正常；0：调用不正常。参数：WndName，用户窗口名，字符型。Op: 操作用户窗口的方法，数值型。Op=1：打开窗口并使其可见。Op=2：打开窗口并使其不可见。Op=3：关闭窗口。Op=4：打印窗口。Op=5：刷新窗口。实例：!SetWindow(工况图，1)，打开用户窗口“工况图，并使其可见。!SysWindow()函数意义：执行该函数后，打开用户窗口管

9、理窗口，在管理窗口中可以选择打开或关闭指定的用户窗口。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：无。实例：!SysWindow()!DisableCtrlAltDel()函数意义：屏蔽热键Ctrl+Alt+Del的功能。无法打开任务管理器窗口或执行锁定计算机注销关机密码修改等操作。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：无。实例：!DisableCtrlAltDel()注意此函数在网络版客户端和WIN98操作系统下无效。!EnableCtrlAltDel()函数意义：恢复热键Ctrl+Alt+Del的功能。使用任务管理器关闭不响应的程序或执行锁定计算机注销关机

10、修改密码等,为了维护系统安全的操作。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：无。实例：!EnableCtrlAltDel()注意：1. 不要把这两个脚本函数同时使用，否如此，看不到任何效果，没有任何意义；2. 不要把这两个函数放到循环中使用；3. 在使用这2个脚本函数时，最好与登录密码同时使用，以达到真正的热键屏蔽效果。4. 此函数在网络版客户端和WIN98操作系统下无效。 !RestartProject()函数意义：当检查组态工程在运行过程中出现非正常状态，可以调用该函数重新启动运行环境。该功能必须在加密狗生效时方可工作。返回值：无。参数：无。实例：!RestartProj

11、ect()数据对象操作函数!AnswerAlm(DatName)函数意义：应答数据对象DatName所产生的报警。如对应的数据对象没有报警产生或已经应答，如此本函数无效。返回值：数值型，=0为操作成功；0为操作失败。参数：DatName，数据对象名；实例：!AnswerAlm(电机温度)，应答数据对象“电机温度所产生的报警。!ChangeDataSave(Datname，n)函数意义：改变数据对象Datname存盘的周期。返回值：数值型，=0为操作成功；0为操作失败。参数：Datname，数据对象名；n，数值型，以秒表示的存盘间隔时间实例：ChangeDataSave(温度，5)，温度的存盘间

12、隔时间为5秒!ChangeSaveDat(DatName，Num1，Num2)函数意义：改变数据对象DatName所对应存盘数据的存盘间隔，把Num1小时以前的存盘数据以当前时间为0点的存盘间隔改为Num2秒。本操作只对组对象有效，对单个的数据对象无效。当DataName =空字符，或Num1=0或Num2=0时，本操作无效。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：DatName：数据对象名。Num1：数值型时间量，单位：小时。本函数用Num10的一些数值来表示一些特殊意义的操作：=-1 改变当天对应数据对象所有存盘数据的存盘间隔；=-2 改变昨天对应数据对象所有存盘数据的

13、存盘间隔；=-3 改变本星期对应数据对象所有存盘数据的存盘间隔；=-4 改变上星期对应数据对象所有存盘数据的存盘间隔；=-5 改变本月对应数据对象所有存盘数据的存盘间隔；=-6 改变上个月对应数据对象所有存盘数据的存盘间隔；Num2：数值型时间量，新的存盘间隔，单位：秒。实例：! ChangeSaveDat(电机1， -2， 5)，把组对象“电机1对应的存盘数据中昨天的存盘数据的存盘间隔改为5秒钟。!CopySaveDat(Tdb,Sdb,TabName,TimeField,Flag )函数意义：拷贝数据库中数据表的数据返回值：开关型，返回值=0：调用正常；返回值0：调用不正常。参数：Tdb，

14、目标数据库名；Sdb，源数据库名；TabName，数据表名；TimeField，定义的时间字段名；Flag，拷贝方式，0：覆盖拷贝；1：添加拷贝。实例：！CopySaveDatTdb，Sdb，TabName，TimeField，0，将数据库Sdb中表TabName中的数据拷贝到数据库Tdb中，表名仍是TabName，定义的时间字段为TimeField，拷贝方式为覆盖拷贝。!DelAllSaveDat(DatName)函数意义：删除数据对象DatName对应的所有存盘数据。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：DatName，数据对象名。实例：! DelAllSaveDat

15、(电机温度) ，删除数据对象“电机温度对应的所有存盘数据。!DelAllAlmDatDatName函数意义：删除数据对象DataName对应的所有报警存盘数据。注意，此函数不能用来删除组对象所对应的报警存盘数据。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：DatName：数据对象名；实例：！DelAllAlmDat电机温度，删除数据对象“电机温度对应的所有报警存盘数据!DelAlmDat(DatName，Num)函数意义：删除数据对象DataName对应的报警存储数据中最早Num小时内的报警存储数据，如Num=0或DatName=空字符，如此该函数无效。返回值：数值型，返回值=

16、0：调用正常；0：调用不正常。参数：DatName：数据对象名；Num：数值型时间值，单位：小时。实例：! DelAlmDat(电机温度，1)，删除数据对象“电机温度对应的报警存盘数据中最早1小时内的数据。!DelSaveDat(DatName，Num)函数意义：删除数据对象DataName对应的存盘数据中最早Num小时内的存盘数据，如Num=0或DatName=空字符，如此该函数无效。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：DatName：数据对象名；Num：数值型时间值，单位：小时。实例：! DelSaveDat(电机温度，12) ，删除数据对象“电机温度对应的存盘数据

17、中最早12小时内的数据。!EnableAlm(name，n)函数意义：打开/关闭数据对象的报警功能。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：name，变量名；n，数值型，1表示打开报警，0表示关闭报警实例：!EnableAlm(电机温度，1)，打开电机温度的报警功能!EnableDataSave(name，n)函数意义：打开/关闭数据对象的定时存盘功能。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：name，数据对象名；n，数值型，1表示打开定时存盘，0表示关闭定时存盘实例：!EnableDataSave(温度，1)，打开温度的定时存盘!GetAlmValue

18、(DatName，Value，Flag)函数意义：读取数据对象DatName报警限值，只有在数据对象DatName的“允许进展报警处理属性选项被选中后，本函数的操作才有意义。对组对象、字符型数据对象、事件型数据对象本函数无效。对数值型数据对象，用Flag来标识读取何种报警限值。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：DatName：数据对象名。Value：DataName的当前的报警限值，数值型。Flag：数值型，标志要读取何种限值，具体意义如下：=1下下限报警值；=2 下限报警值；=3 上限报警值；=4 上上限报警值；=5 下偏差报警限值；=6 上偏差报警限值；=7 偏差

19、报警基准值；实例：! GetAlmValue(电机温度， Value， 3)，读取数据对象“电机温度的报警上限值，放入数值型数据对象Value中。!GetEventDT(EvName)函数意义：返回当前事件和上一次事件之间的时间差，单位为秒。返回值：数值型。返回的时间差参数：EvName，事件变量名，事件型。实例：!GetEventDT(EvName)，取事件变量EvName当前事件和上一次事件之间的时间差，单位为秒。!GetEventP(EvName)函数意义：取到当前事件的附加说明字符串。返回值：字符型。返回的附加说明字符串。参数：EvName，事件变量名，事件型。实例：!GetEvent

20、P(EvName) ，取事件型变量EvName的当前事件的附加说明字符串。!GetEventT(EvName)函数意义：取到当前事件产生的时间，以秒为单位，相对于1980年以来的秒数。如没有事件产生，返回-1。返回值：数值型。参数：EvName，事件变量名，事件型。实例：!GetEventT(EvName)，取事件型变量EvName的当前事件产生时刻。!MoveAlmDat(DatName，FileName，Num1，Num2，Flag)函数意义：把数据对象DatName所对应的报警存盘信息中的第Num1小时到Num1+Num2小时内以当前时间为0点的报警存盘信息提取出来，转存到FileNam

21、e所指定的数据库文件中Access数据库。当DatName=空字符，或FileName=空字符，或Num20时，本函数无效。删除数据对象DatName对应的所有报警存储数据。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：DatName：数据对象名。FileName：新的报警存盘文件名(包括路径)，字符型。Num1：数值型时间量，单位：小时。本函数用Num10的一些数值来表示一些特殊意义的操作此时Num2无效：=-1 转存当天的所有报警信息存盘数据；=-2 转存昨天的所有报警信息存盘数据；=-3 转存本星期的所有报警信息存盘数据；=-4 转存上星期的所有报警信息存盘数据；=-5 转

22、存本月的所有报警信息存盘数据；=-6 转存上个月的所有报警信息存盘数据；Num2：数值型时间量，单位：小时。Flag：转存标志，数值型。Flag=0时，创建一个新文件(如原文件已存在，如此把原文件改名为*.BK1)；Flag=1时，在原有的根底上增加新的数据。实例：!MoveAlmDat(电机温度， D:Tempttt.mdb，-6，0，1)，把数据对象“电机温度对应的报警存盘数据中的上个月的所有报警信息存盘数据转存添加到数据库文件D:Tempttt.mdb中。!MoveSaveDat(DatName，FileName，Num1，Num2，Flag)函数意义：把数据对象DatName所对应的存

23、盘数据中的第Num1小时到Num1+Num2小时内以当前时间为0点的存盘数据提取出来，转存到FileName所指定的数据库文件中Access数据库。当DatName=空字符，或FileName=空字符，或Num20时，本函数无效。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：DatName：数据对象名。FileName：新的存盘数据文件名(包括路径)，字符型。Num1：数值型时间量，单位：小时。本函数用Num10的一些数值来表示一些特殊意义的操作此时Num2无效：=-1 转存当天对应数据对象的所有存盘数据；=-2 转存昨天对应数据对象的所有存盘数据；=-3 转存本星期对应数据对象

24、的所有存盘数据；=-4 转存上星期对应数据对象的所有存盘数据；=-5 转存本月对应数据对象的所有存盘数据；=-6 转存上个月对应数据对象的所有存盘数据；Num2：数值型时间量，单位：小时。Flag：转存标志，数值型。Flag=0时，创建一个新文件(如原文件已存在，如此把原文件改名为*.BK1)；Flag=1时，在原有的根底上增加新的数据。实例：! MoveSaveDat(电机温度， D:Tempttt.mdb，-6，0，1) 把数据对象“电机温度对应的存盘数据中的上个月的所有存盘数据转存添加到数据库文件“中。!SaveData(DatName)函数意义：把数据对象DataName对应的当前值存

25、入存盘数据库中。本函数的操作使对应的数据对象的值存盘一次。此数据对象必须具有存盘属性，且存盘时间需设为0秒。否如此会操作失败。返回值：数值型，=0为操作成功；0为操作失败。参数：DatName，数据对象名。实例：! SaveData(电机1)，把组对象“电机1的所有成员对应的当前值存盘一次。!SaveDataInit()函数意义：本操作把设置有“退出时自动保存数据对象的当前值作为初始值属性的数据对象的当前值存入组态结果数据中作为初始值，防止突然断电而无法保存，以便MCGS下次启动时这些数据对象能自动恢复其值。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：无。实例：! SaveDa

26、taInit()!SaveDataOnTime(Time，TimeMS,DataName)函数意义：使用指定时间保存数据。本函数通常用于指定时间来保存数据，实现与通常机制不一样的存盘方法。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：Time，整型，使用时间函数转换出的时间量。时间精度到秒。TimeMS，整型，指定存盘时间的毫秒数。DataName， 数据对象名。实例：t = !TimeStr2I(“2001年2月21日3时2分3秒)!SaveDataOnTime (t，0,DataGroup)，按照指定时间保存数据对象!SaveSingleDataInit(Name)函数意义：

27、本操作把数据对象的当前值设置为初始值不管该对象是否设置有“退出时自动保存数据对象的当前值作为初始值属性，防止突然断电而无法保存，以便MCGS下次启动时这些数据对象能自动恢复其值。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：Name，数据对象名。实例：!SaveSingleDataInit(温度)，把温度的当前值设置成初始值。!SetAlmValue(DatName，Value，Flag)函数意义：设置数据对象DatName对应的报警限值，只有在数据对象DatName“允许进展报警处理的属性被选中后，本函数的操作才有意义。对组对象、字符型数据对象、事件型数据对象本函数无效。对数值

28、型数据对象，用Flag来标识改变何种报警限值。返回值：数值型，返回值=0：调用正常；0：调用不正常。参数：DatName：数据对象名。Value：新的报警值，数值型。Flag：数值型，标志要操作何种限值，具体意义如下：=1下下限报警值；=2下限报警值；=3上限报警值；=4上上限报警值；=5下偏差报警限值；=6上偏差报警限值；=7偏差报警基准值；实例：! SetAlmValue(电机温度， 200， 3)，把数据对象“电机温度的报警上限值设为200用户登录操作函数!ChangePassword()函数意义：弹出密码修改窗口，供当前登录的用户修改密码。返回值：数值型。返回值=0：调用成功；0：调用

29、失败。参数：无。实例：!ChangePassword()!CheckUserGroup(strUserGroup)函数意义：检查当前登录的用户是否属于strUserGroup用户组的成员。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：strUserGroup，字符型，用户组的名称。实例：! CheckUserGroup(管理员组)!Editusers()函数意义：弹出用户管理窗口，供管理员组的操作者配置用户。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：无。实例：!Editusers()!EnableExitLogon(n)函数意义：打开/关闭退出时的权限检查返回值：无

30、参数：n，数值型，为1时表示在退出时进展权限检查，当权限不足时，会进展提示。为0如此退出时不进展权限检查。实例：!EnableExitLogon(1)，在退出时进展权限检查!EnableExitPrompt (n)函数意义：打开/关闭退出时的提示信息返回值：无参数：n，数值型，为1时表示在退出时弹出提示信息对话框。为0如此退出时不出现信息对话框。实例：!EnableExitLogon(1)，在退出时弹出提示信息对话框!GetCurrentGroup()函数意义：读取当前登录用户的所在用户组名。返回值：字符型，当前登录用户组名，如没有登录返回空。参数：无。实例：!GetCurrentGroup(

31、)!GetCurrentUser()函数意义：读取当前登录用户的用户名。返回值：字符型，当前登录用户的用户名，如没有登录返回空。参数：无。实例：!GetCurrentUser()!LogOff()函数意义：注销当前用户。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：无。实例：!LogOff()!LogOn()函数意义：弹出登录对话框。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：无。实例：!LogOn()!GetUserNameByIndex()函数意义：按索引号取得当前用户名。返回值：字符型。与索引号相对应的当前用户名。参数：索引号值。实例：!GetUserNameB

32、yIndex(0) ,索引为0的用户名称。!GetGroupNameByIndex()函数意义：按索引号取得当前用户组名。返回值：字符型。与索引号相对应的当前用户组名。参数：索引号值。实例：!GetGroupNameByIndex(0) ,索引为0的用户组名称。!GetProjectTotalUsers ()函数意义：取得当前工程用户总数。返回值：开关型。当前工程用户总数。参数：无实例： !GetProjectTotalUsers(),激活该函数,取得当前工程的用户总数。字符串操作函数!Ascii2I(s)函数意义：返回字符串s的首字母的Ascii值。返回值：开关型。参数：s，字符型。实例：!

33、Ascii2I(“Afd) =65!Bin2I(s)函数意义：把二进制字符串转换为数值。返回值：开关型。参数：s，字符型。实例：!Bin2I(“101) =5!Format(n，str)函数意义：格式化数值型数据对象返回值：字符型。参数：n，数值型，要格式化的数值；str，字符型，格式化数值的格式。表示为0.00样式。小数点后的0的个数表示需要格式化出的小数位数。小数点前的0为一个时，表示小数点前根据实际数值显示。当小数点前没有0时，表示为.xx式样，当小数点前的0不止一个时，使用0来填充不够的位数。实例：!Format(1.236，0.00) = 1.24；!Format(1.236，.00

34、) = .24；!Format(1.236，00.00) = 01.24；!Hex2I(s)函数意义：把16进制字符串转换为数值。返回值：开关型。参数：s，字符型。实例：!Hex2I (“11) =17!I2Ascii(s)函数意义：返回指定Ascii值的字符。返回值：字符型。参数：s，开关型。实例：!I2Ascii(65) =A!I2Bin(s)函数意义：把数值转换为二进制字符串。返回值：字符型。参数：s，开关型。实例：!I2Bin (5) =“101!I2Hex(s)函数意义：把数值转换为16进制字符串。返回值：字符型。参数：s，开关型。实例：!I2Hex (17) =“11!I2Oct(

35、s)函数意义：把数值转换为8进制字符串。返回值：字符型。参数：s，开关型。实例：!I2Oct (9) =“11!InStr(n，str1，str2)函数意义：查找一字符串在另一字符串中最先出现的位置返回值：数值型。参数：n，数值型，开始搜索的位置；str1，字符串，被搜索的字符串；str2，字符串，要搜索的字符串实例：!InStr(3，sdlkfjwe，we) = 7实例：!InStr(1，wesdlkfjwe，we) = 1,表示从str1字符串的第一个字符位置搜索str2字符串，返回最先出现的位置!Lcase(str)函数意义：把字符型数据对象str的所有字符转换成小写。返回值：字符型。参

36、数：str，字符型。实例：!LCase(sedERT) = sedert!Left(str，n)函数意义：字符型数据对象str左边起，取n个字符。返回值：字符型。参数：str：字符型，源字符串；n，数值型，取字符个数。实例：!Left(ABCDEFG，2) =AB!Len(Str)函数意义：求字符型数据对象str的字符串长度字符个数。返回值：数值型。参数：str，字符型。实例：!Len(ABCDEFG) = 7!Ltrim(str)函数意义：把字符型数据对象str中最左边的空格剔除。返回值：字符型。参数：str，字符型。实例：!LTrim( dsfk ) = dsfk !lVal(str)函数

37、意义：将数值类字符串转化为长整型数值返回值：开关型，转换出的数值。参数：str，字符型。要求待转换的字符串为数值类字符串实例：!lVal(“12345678)=12345678!Mid(str，n，k)函数意义：从字符型数据对象str左边第n个字符起，取k个字符。返回值：字符型。参数：str，字符型，源字符串；n，数值型，起始位置；k，数值型，取字符数。实例：!Mid(ABCDEFG，3，2) = CD!Oct2I(s)函数意义：把8进制字符串转换为数值。返回值：开关型。参数：s，字符型。实例：!Oct2I (“11) =9!Right(str，n)函数意义：从字符型数据对象str右边起，取n

38、个字符。返回值：字符型。参数：str，字符型，源字符串；n，数值型，取字符个数。实例：!Right(ABCDEFG，2) =FG!Rtrim(str)函数意义：把字符型数据对象str中最右边的空格剔除。返回值：字符型。参数：str，字符型。实例：!LTrim( dsfk ) = dsfk!Str(x)函数意义：将数值型数据对象x的值转换成字符串。返回值：字符型。参数：x，数值型。实例：!Str(0.712) =0.712!Strp(str1，str2)函数意义：比拟字符型数据对象str1和str2是否相等，返回值为0时相等，否如此不相等。不区分大小写字母。返回值：数值型。参数：str1，字符型

39、；str2，字符型。实例：!Strp(ABC,abc) = 0!StrFormat(FormatStr,任意个数变量)函数意义：格式化字符串，可以格式化任意多个数值。使用方法为!StrFormat(“%d,23)或!StrFormat(“%g-%g-%g,2.3,2.1,2.2)等，类似C语言中的Printf的语法。返回值：字符型。参数：FormatStr，字符型，格式化字符串，如：“%d、 “%g。后面的参数可以任意多个。实例：!StrFormat(%g-%g,12,12.34)= 12-12.34注 意：输出多个数值时，可以使用在多个格式化字符串之间，添加分格符的方法，区别任意个数的输出变

40、量。如：%g-%g、%g-%g-%g。!Trim(str)函数意义：把字符型数据对象str中左右两端的空格剔除。返回值：字符型。参数：str，字符型。实例：!Trim( dsfk ) =dsfk!Ucase(str)函数意义：把字符型数据对象str的所有字符转换成大写。返回值：字符型。参数：str，字符型。实例：!UCase(sedERT) =SEDERT!Val(str)函数意义：把数值类字符型数据对象str的值转换成数值。返回值：数值型。参数：str，字符型。实例：注 意：使用表签控件显示输出时，必需设置小数位数的个数；否如此系统将以四舍五入的规如此，显示输出整数数值。定时器操作函数定时器

41、号：系统定时器的序号1127，MCGS系统内嵌127个系统定时器。系统定时器以秒为定时单位。!TimerClearOutput(定时器号)函数意义:断开定时器的数据输出连接返回值：数值型。返回值=0：调用成功；0：调用失败。参数：定时器号。实例：!TimerClearOutput(1)，断开1号定时器的数据输出连接!TimerRun(定时器号)函数意义：启动定时器开始工作返回值：数值型。返回值=0：调用成功；0：调用失败。参数：定时器号实例：!TimerRun(1)，启动1号定时器工作。!TimerStop(定时器号)函数意义：停止定时器工作返回值：数值型。返回值=0：调用成功；0：调用失败。

42、参数：定时器号实例：!TimerStop(1 )，停止1号定时器工作。!TimerSkip(定时器号，步长值)函数意义：在计时器当前时间数上加/减指定值返回值：数值型。返回值=0：调用成功；0：调用失败。参数：定时器号；步长值实例：!TimerSkip(1，3)，1号定时器当前值+3!TimerReset(定时器号，数值)函数意义：设置定时器的当前值，由第二个参数设定，第二个参数可以是MCGS变量返回值：数值型。返回值=0：调用成功；0：调用失败。参数：定时器号；数值实例：!TimerReset(1，12)，设置1号定时器的值为12!TimerValue(定时器号，0)函数意义：取定时器的当前

43、值返回值：将定时器的值以数值型的方式输出数值格式参数：定时器号实例：Data3=!TimerValue(1，0)，取定时器1的值给Data3!TimerStr(定时器号，转换类型)函数意义：以时间类字符串的形式返回当前定时器的值返回值：字符型变量，将定时器的值以字符型的方式输出时间格式参数：定时器号转换类型值：开关型= 0：取定时器的值以“00：00形式输出；= 1：取定时器的值以“00：00：00形式输出；= 2：取定时器的值以“0 00：00：00形式输出；= 3：取定时器的值以“形式输出；实 例：Time=!TimerStr(1，1)，取定时器的值以“00：00：00形式输出给Time!

44、TimerState(定时器号)函数意义：取定时器的工作状态返 回 值：数值型变量，0 - 定时器停止，1 - 定时器运行参 数：定时器号实 例：data1=!TimerState(1)，取定时器1的工作状态给data1 !TimerSetLimit(定时器号，上限值，参数3)函数意义：设置定时器的最大值，即设置定时器的上限返 回 值：数值型。返回值=0：调用成功；0：调用失败。参 数：定时器号；上限值；参数3，1 - 表示运行到60后停止；0 - 表示运行到60后重新循环运行实 例：!TimerSetLimit(1，60，1)，设置1号定时器的上限为60，运行到60后停止。!TimerSet

45、Output(定时器号，数值型变量)函数意义：设置定时器的值输出连接的数值型变量返 回 值：数值型。返回值=0：调用成功；0：调用失败。参 数：定时器号；数值型变量，定时器的值输出连接的数值型变量实 例：!TimerSetOutput(1，Data0)，将1号定时器的数据连接到Data0!TimerWaitFor(定时器号，数值)函数意义：等待定时器工作到“数值指定的值后，脚本程序才向下执行返 回 值：数值型。返回值=0：调用成功；0：调用失败。参 数：定时器号；数值， 等待定时器工作到指定的值实 例：!TimerWaitFor(1，55)，等定时器工作到55秒后再执行其他操作系统操作函数!A

46、ppActive(Title)函数意义：激活指定的应用程序。使用时一般先用!Shell函数启动指定的应用程序，然后用本函数激活应用程序，再用!SendKeys函数发送击键消息，控制应用程序的执行。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：Title，字符型，字符串表达式，所要激活的应用程序窗口的标题。实例：!Shell(D:OfficeExcel.exe，6)! AppActive(“Microsorft Excel Book1) 说明：AppActivate 语句将焦点移动到命名的应用程序或窗口，但并不影响焦点是否最大化或最小化。当用户采取行动改变焦点或将窗口关闭时，就会将焦

47、点从活动的应用程序窗口移动出去。可用 Shell 函数启动一个应用程序并设置窗口样式。在决定激活哪个应用程序时，将 title 与每一个运行中的应用程序的标题字符串进展比拟。如果没有完全匹配，就激活任何这样的应用程序，其标题字符串以 title 开头。如果以 title 命名的应用程序有很多实例，如此激活任意一个实例。!Beep()函数意义：发出嗡鸣声。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：无。实例：!Beep()!EnableDDEConnection(DatName,n)函数意义：启动/停止数据对象的DDE连接。返回值：数值型。返回值=0：调用失败；0:调用成功。参数：

48、DatName，数据对象名；n，数值型，为1时表示启动数据对象的DDE连接。为0时如此停止数据对象的DDE连接。实例：!EnableDDEConnection(温度，1)，启动数据对象“温度的DDE连接。!EnableDDEInput(DatName,n)函数意义：启动/停止数据对象的DDE连接时外部数值的输入。返回值：数值型。返回值=0：调用成功；0:调用失败。参数：DatName,数据对象名；n，数值型，为1时表示启动数据对象的DDE连接，接收外部数值的输入。为0时如此停止数据对象的DDE连接过程中外部数值的输入。实例：!EnableDDEConnection(压力，1)，启动数据对象“压

49、力的DDE连接，接收外部数值的输入。!EnableDDEOutput (DatName,n)函数意义：启动/停止数据对象的DDE连接时向外部输出数值。返回值：数值型。返回值=0：调用成功；0:调用失败。参数：DatName,数据对象名；n，数值型，为1时表示启动数据对象的DDE连接时向外部输出数值的功能。为0时如此停止数据对象的DDE连接时向外部输出数值的功能。实例：!EnableDDEConnection(压力，1)，启动数据对象“压力通过 DDE连接向外部输出数值的功能。!LinePrtOutput (str)函数意义：输出到行式打印机。返回值：数值型。返回值=0：调用成功；0:调用失败。

50、参数：str，字符型。实例：!LinePrtOutput (“ABCDEFG)，将字符串输出到行式打印机。!PlaySound(SndFileName，Op)函数意义：播放声音文件。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：SndFileName，字符型，声音文件的名字。Op，开关型= 0：停止播放。= 1：同步播放，播放完毕后再返回在播放完成之前不能进展其它的操作。= 2：播放一遍，启动播放，立即返回。= 3：循环播放，启动循环播放后立即返回。实例：!PlaySound(“，1)播放声音文件。!SendKeys(string)函数意义：将一个或多个按键消息发送到活动窗口，就如

51、同在键盘上进展输入一样。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：string，字符串表达式，指定要发送的按键消息。实例：!SendKeys(%F4)，给当前激活的程序发送Alt+F4击键消息。说明：每个按键由一个或多个字符表示。为了指定单一键盘字符，必须按字符本身的键。例如，为了表示字母 A，可以用 A 作为 string。为了表示多个字符，就必须在字符后面直接加上另一个字符。例如，要表示 A、B 与 C，可用 ABC 作为 string。对 SendKeys 来说，加号 (+)、插入符 ()、百分比符号 (%)、上划线 () 与圆括号 ( ) 都具有特殊意义。为了指定上述任

52、何一个字符，要将它放在大括号 () 当中。例如，要指定正号，可用 + 表示。为了指定大括号字符，请使用 与 。为了在按下按键时指定那些不显示的字符，例如：ENTER 或 TAB 以与那些表示动作而非字符的按键，请使用如下代码：按键代码BACKSPACEBACKSPACE, BS, 或 BKSPBREAKBREAKCAPS LOCKCAPSLOCKDEL or DELETEDELETE 或 DELDOWN ARROWDOWNENDENDENTERENTER或 ESCESCHOME HOMEINS or INSERTINSERT 或 INS- 70 - / 70LEFT ARROWLEFTNUM

53、LOCKNUMLOCKPAGE DOWNPGDNPAGE UPPGUPRIGHT ARROWRIGHTSCROLL LOCKSCROLLLOCKTABTABUP ARROWUPF1F1F2F2F3F3F4F4F5F5F6F6F7F7F8F8F9F9F10F10F11F11F12F12F13F13F14F14F15F15F16F16为了指定那些与 SHIFT、CTRL 与 ALT 等按键结合的组合键，可在这些按键码的前面放置一个或多个代码，这些代码列举如下：按键代码SHIFT+CTRL ALT %为了说明在按下其它按键时应同时按下 SHIFT、CTRL、与 ALT 的任意组合键，请把那些按键的码

54、放在括号当中。例如，为了说明按下 E 与 C 的时候同时按下 SHIFT 键，请使用 +(EC)。为了说明在按下 E 的时候同时按下 SHIFT 键，但接着按 C 而不按 SHIFT，如此使用+EC。注意：不能用 SendKeys 将按键消息发送到这样一个应用程序，这个应用程序并没有被设计成在 Microsoft Windows 中运行。 Sendkeys 也无法将 PRINT SCREEN 按键 PRTSC 发送到任何应用程序。!SetLinePrinter(n)函数意义：打开/关闭行式打印输出。返回值：数值型。返回值=0：调用成功；0:调用失败。参数：n,数值型，1，表示打开行式打印输出；

55、0，如此关闭行式打印输出。实例：!SetLinePrinter(1),打开行式打印输出。!SetTime(n1，n2，n3，n4，n5，n6)函数意义：设置当前系统时间返回值：数值型。返回值=0：调用成功；0：调用失败。参数：n1，数值型，设定年数，小于1000和大于9999时不变；n2，数值型，设定月数，大于12和小于1时不变；n3，数值型，设定天数，大于31和小于1时不变；n4，数值型，设定小时数，大于23和小于0时不变；n5，数值型，设定分钟数，大于59和小于0时不变；n6，数值型，设定秒数，大于59和小于0时不变。实例：!SetTime(2000，1，1，1，1，1)，设置当前系统时间

56、为2000年1月1日1时1分1秒。!Shell(pathname，windowstyle)函数意义：启动并执行指定的外部可执行文件。返回值：数值型。返回值=0：调用成功；=1：调用失败。参数：pathname，字符型，要执行的外部应用程序的名称，以与任何必需的参数或命令行变量，包括路径。windowstyle，数值型，指定被执行的外部应用程序窗口的状态。windowstyle 命名参数有以下这些值：常量值描述VbHide 0窗口被隐藏，且焦点会移到隐式窗口。VbNormalFocus 1窗口具有焦点，且复原到它原来的大小和位置。VbMinimizedFocus 2窗口会以一个具有焦点的图标来显

57、示。VbMaximizedFocus 3窗口是一个具有焦点的最大化窗口。VbNormalNoFocus 4窗口会被复原到最近使用的大小和位置，而当前活动的窗口仍然保持活动。VbMinimizedNoFocus 6窗口会以一个图标来显示。而当前活动的的窗口仍然保持活动。实例：!Shell(D:OfficeExcel.exe，3)，启动Excel，并使其最大化显示。说明：如果Shell 函数成功地执行了所要执行的文件，如此它会返回程序的任务ID。任务ID是一个唯一的数值，用来指明正在运行的程序。注意：Shell 函数是以异步方式来执行其它程序的。也就是说，用Shell 启动的程序可能还没有完成执行

58、过程，就已经执行到 Shell 函数之后的语句。!Sleep(mTime)函数意义：在脚本程序中等待mTime毫秒，然后再执行下条语句。只能在策略中使用，否如此会造成系统响应缓慢。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：mTime，数值型，要等待的毫秒数。实例：!Sleep(10)!TerminateApplication(AppName，Timeout)函数意义：强行关闭指定的应用程序。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：AppName，字符型，应用程序标题名，也就是显示在任务栏上的应用程序的名字。Timeout，开关型，等待超时时间，以秒为单位实例：

59、!TerminateApplication(Microsoft Excel - Book1,5)关闭microsoft excel - book1!WaitFor (Dat1，Dat2)函数意义：在脚本程序中等待设置的条件满足，脚本程序再向下执行。只能在策略中使用，否如此造成系统响应缓慢。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：Dat1，数值型，条件表达式，如：D=15。Dat2，数值型，等待条件满足的超时时间，单位：ms。为0如此无限等待。实例：！WaitForD=15，12000，等变量D的值等于15后，程序再继续执行，如果在12秒后条件仍然没有满足，也自动继续执行。此函

60、数通常用于做实验时，等待某个条件满足，然后再接着执行实验流程。他与Sleep函数以与While循环语句、其他循环策略配合，能够实现复杂的流程调度。注意：！WaitFor只能用于策略中，而不能直接在窗口控件的脚本程序中使用。!WinHelp(HelpFileName，umand，dwData)函数意义：调用Windows帮助文件。返回值：数值型。返回值=0：调用成功；0：调用失败。参数：HelpFileName，字符型，帮助文件名。Umand，开关型，=1，显示由上下文编号标识的特定主题的帮助。=2，关闭帮助窗口。=3，弹出帮助内容。=11，弹出查找帮助对话框。当Umand =2，3，11时，dwData = 0,开关型当Umand=1时，dwData为上下文编号的数值实例：!WinHelp(“!Navigate(WebAddress)函数意义：引导浏览器浏览其他的网页，只有在使用版进展IE浏览时有效。返回值：开关型，返回值=0，调用成功；返回值0，