MCGS系统内部函数参考手册（最新版-修订）新修订

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

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

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

4、tgyName(0)，取 0 号运行策略的名称。 !GetWindowName(Index) 函数意义：函数意义：按用户窗口的顺序获得用户窗口的名字。 返 回 值：返 回 值：字符型。 参 数：参 数：Index， 数值型。 实 例：实 例：!GetWindowName(0) ，读取 0 号用户窗口的名称。 !GetWindowState(WndName) 函数意义：函数意义：按照名字取得用户窗口的状态。 返 回 值：返 回 值：数值型。 返回 0：用户窗口处于关闭状态。 返回 1：用户窗口处于打开状态。 返回 2：用户窗口处于隐藏状态。 参 数：参 数：WndName，用户窗口名称，字符型。 实 例：实 例：!GetWindowState(工况图)，获得用户窗口“工况图”的状态 3 !SetActiveX(Activename，n，str) 函数意义：函数意义：操作指定的动画构件， 向窗口中的 ActiveX 控件发出控件命令 返 回 值：返 回 值：无 参 数：参 数：Activename，字符型，控件名称，用“.”分割窗口名和控件名，如:窗 口 0.控件 1 表示在用户窗口“窗口

5、 0”中的名为“控件 1”的控件。 n，数值型，命令类型，请填 1； str，字符型，命令字符串，具体含义请参照控件帮助。 实 例实 例 ： !SetActiveX(“窗口 0.控件 0”,1,”start”)，启动窗口 0 的控件 0 开 始工作。 !SetDevice(DevName，DevOp，CmdStr) 函数意义：函数意义：按照设备名字对设备进行操作。 返 回 值：返 回 值：数值型。返回值：=0：调用正常；0：调用不正常。 参 数：参 数：DevName，设备名，字符型； DevOp，设备操作码，数值型； CmdStr，设备命令字符串，只有当 DevOp=6 时 CmdStr 才有意义。 DevOp 取值范围及相应含义： 1：启动设备开始工作。 2：停止设备的工作使其处于停止状态。 3：测试设备的工作状态。 4：启动设备工作一次。 5：改变设备的工作周期，CmdStr 中包含新的工作周期，单位为 ms。 6：执行指定的设备命令，CmdStr 中包含指定命令的格式。 实 例 ：实 例 ： !SetDevice(OmronPLC，1， )，启动设备构件“OmronPLC”开始

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

7、；0：调用失败。 参 数：参 数：无。 实 例：实 例：!SysWindow() !DisableCtrlAltDel() 函数意义：函数意义：屏蔽热键 Ctrl+Alt+Del 的功能。无法打开任务管理器窗口或执行锁 定计算机注销关机密码修改等操作。 返 回 值：返 回 值：数值型。返回值=0：调用成功；0：调用失败。 参 数：参 数：无。 实 例：实 例：!DisableCtrlAltDel() 注 意注 意此函数在网络版客户端和 WIN98 操作系统下无效。 !EnableCtrlAltDel() 函数意义：函数意义：恢复热键 Ctrl+Alt+Del 的功能。使用任务管理器关闭不响应的程序 或执行锁定计算机注销关机修改密码等,为了维护系统安全的操作。 返 回 值：返 回 值：数值型。返回值=0：调用成功；0：调用失败。 参 数：参 数：无。 实 例：实 例：!EnableCtrlAltDel() 注 意：注 意：1. 不要把这两个脚本函数同时使用，否则，看不到任何效果，没有任何 意义； 2. 不要把这两个函数放到循环中使用； 3. 在使用这 2 个脚本函数时，最好与登录密码同时

8、使用，以达到真正的热键屏 蔽效果。 4. 此函数在网络版客户端和 WIN98 操作系统下无效。 !RestartProject() 函数意义 ：函数意义 ： 当检查组态工程在运行过程中出现非正常状态，可以调用该函数重新 启动运行环境。该功能必须在加密狗生效时方可工作。 返 回 值：返 回 值：无。 参 数：参 数：无。 实 例：实 例：!RestartProject() 数据对象操作函数数据对象操作函数 5 !AnswerAlm(DatName) 函数意义 ：函数意义 ： 应答数据对象 DatName 所产生的报警。如对应的数据对象没有报警产 生或已经应答，则本函数无效。 返 回 值：返 回 值：数值型，=0 为操作成功；0 为操作失败。 参 数：参 数：DatName，数据对象名； 实 例：实 例：!AnswerAlm(电机温度)，应答数据对象“电机温度”所产生的报警。 !ChangeDataSave(Datname，n) 函数意义：函数意义：改变数据对象 Datname 存盘的周期。 返 回 值：返 回 值：数值型，=0 为操作成功；0 为操作失败。 参 数：参 数：Datname

9、，数据对象名； n，数值型，以秒表示的存盘间隔时间 实 例：实 例：ChangeDataSave(温度，5)， 温度的存盘间隔时间为 5 秒 !ChangeSaveDat(DatName，Num1，Num2) 函数意义：函数意义：改变数据对象 DatName 所对应存盘数据的存盘间隔，把 Num1 小时以 前的存盘数据（以当前时间为 0 点）的存盘间隔改为 Num2 秒。本操作只对组对 象有效， 对单个的数据对象无效。 当 DataName =空字符， 或 Num1=0 或 Num2=0 时， 本操作无效。 返 回 值：返 回 值：数值型，返回值=0：调用正常；0：调用不正常。 参 数：参 数：DatName：数据对象名。 Num1：数值型时间量，单位：小时。本函数用 Num10 的一些数值来表示一些特 殊意义的操作： =-1 改变当天对应数据对象所有存盘数据的存盘间隔； =-2 改变昨天对应数据对象所有存盘数据的存盘间隔； =-3 改变本星期对应数据对象所有存盘数据的存盘间隔； =-4 改变上星期对应数据对象所有存盘数据的存盘间隔； =-5 改变本月对应数据对象所有存盘数据的存盘间隔； =-6 改变上个月对应数据对象所有存盘数据的存盘间隔； Num2：数值型时间量，新的存盘间隔，单位：秒。 实 例 ：实 例 ： ! ChangeSaveDat(电机 1， -2， 5)，把组对象“电机 1”对应的存盘数据 中昨天的存盘数据的存盘间隔改为 5 秒钟。 !CopySaveDat(Tdb,Sdb,TabName,TimeField,Flag ) 函数意义函数意义：拷贝数据库中数据表的数据 返 回 值返 回 值：开关型，返回值=0：调用正常；返回值0：调用不正常。 参 数参 数：Tdb，目标数据库名；Sdb，源数据库名；TabName，数据表名； 6 TimeField，定义的时间字段名；Flag，拷贝方式，0：覆盖拷贝；1：添加拷贝。 实 例实 例： ！CopySaveDat（Tdb，Sdb，TabName，TimeField，0），将数据库 Sdb 中表 TabName 中的数据拷贝到数据库 Tdb 中，表名仍是 TabName，定义的时间字 段为 TimeField，拷贝方式为覆盖拷贝。 !DelAllSaveDat(Da

《MCGS系统内部函数参考手册（最新版-修订）新修订》由会员l****6分享，可在线阅读，更多相关《MCGS系统内部函数参考手册（最新版-修订）新修订》请在金锄头文库上搜索。