MCGS 系统内部函数
MCGS系统内部函数参考手册.docx
MCGS系统内部函数MCGS内部为用户提供了一些常用的数学函数和对MCGS内部对象操作的函数。
组态时，可在表达式中或用户脚本程序中直接使用这些函数。
为了与其它名称相区别，系统内部函数的名称一律以“！”符号开头。
下面分别介绍各个函数的用途和使用方法。
运行环境操作函数!CallBackSvr(DatName)函数意义：调用后台对象返回值：数值型，后台对象的值参数：DatName,对象名，数值型实例：X=! CallBackSvr (X),调用后台数值型对象X注意：本函数在新版本MCGS系统内部，己经无效。
为了保留与旧版本的兼容性, 暂时保留。
!ChangeLoopStgy(StgyName, n)函数意义：改变循坏策略的循环时间返回值：数值型。
返回值二0：调用正常；〈＞0：调用不正常。
参数：StgyName,策略名；n,数值型，以毫秒数表示循环策略的循环时间实例:!ChangeLoopStgy(报警策略，5000),将报警策略的循环时间改为为5 秒!CioseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串"WndName"中指定了一个窗口，则打开这个窗口,关闭其他窗口。
如果” WndName”为空串,则关闭所有窗口。
返回值：数值型。
返回值：二0：调用正常；〈＞0：调用不正常。
参数：WndName,用户窗口名，字符型。
实例:!CloscAllWindow( “工况图”),关闭除了用户窗口“工况图”以外的其他窗I」，若“工况图”窗I」没有打开，则在关闭其他窗I」的同时打开该窗I」!CloseAllWindow( “”)，关闭所有窗口。
!EnableStgy(StgyName, n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返冋值二0：调用正常；＜＞0：调用不正常。
参数：StgyName,策略名；n,数值型，为1时表示打开此策略，为0时表示关闭此策略。
MCGS嵌入版运行环境操作函数
MCGS内部函数运行情况操纵函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环战略的循环时间。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，战略名；n，数值型，以毫秒数体现循环战略的循环时间。
实例：!ChangeLoopStgy(报警战略,5000)，将报警战略的循环时间改为5秒。
!CloseAllWindow(WndName)函数意义：封闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，封闭其他窗口。
如果”WndName”为空串，则封闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloseAllWindow("工况图")，封闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在封闭其他窗口的同时打开该窗口；!CloseAllWindow(" ")，封闭所有窗口。
!CloseAllSubWnd()函数意义：封闭窗口中的所有子窗口。
返回值：浮点型，=0为操纵。
实例：!CloseAllSubWnd()，封闭当前窗口的所有子窗口。
!CloseSubWnd（WndName）函数意义：封闭子窗口。
返回值：浮点型，=1为操纵乐成，<>1为操纵失败。
参数值：WndName：子窗口的名字。
实例：!CloseSubWnd(窗口1)，封闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或封闭某个战略，如报警战略或循环战略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：SstgyName，战略名；n，数值型，为1时体现打开此战略，为0时体现封闭此战略。
实例：!EnableStgy(报警战略,1)，打开报警战略；!EnableStgy(报警战略,0)，封闭报警战略，使报警战略无效。
MCGS嵌入版运行环境操作函数
MCGS内部函数运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时间。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间。
实例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。
!CloseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，关闭其他窗口。
如果”WndName”为空串，则关闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloseAllWindow("工况图")，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloseAllWindow(" ")，关闭所有窗口。
!CloseAllSubWnd()函数意义：关闭窗口中的所有子窗口。
返回值：浮点型，=0为操作。
实例：!CloseAllSubWnd() ，关闭当前窗口的所有子窗口。
!CloseSubWnd（WndName）函数意义：关闭子窗口。
返回值：浮点型，=1为操作成功，<>1为操作失败。
参数值：WndName：子窗口的名字。
实例：!CloseSubWnd(窗口1)，关闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：SstgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。
实例：!EnableStgy(报警策略,1)，打开报警策略；!EnableStgy(报警策略,0)，关闭报警策略，使报警策略无效。
MCGS函数
运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时间。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间。
实例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。
!CloseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，关闭其他窗口。
如果”WndName”为空串，则关闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloseAllWindow("工况图")，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloseAllWindow(" ")，关闭所有窗口。
!CloseAllSubWnd()函数意义：关闭窗口中的所有子窗口。
返回值：浮点型，=0为操作。
实例：!CloseAllSubWnd() ，关闭当前窗口的所有子窗口。
!CloseSubWnd（WndName）函数意义：关闭子窗口。
返回值：浮点型，=1为操作成功，<>1为操作失败。
参数值：WndName：子窗口的名字。
实例：!CloseSubWnd(窗口1)，关闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：SstgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。
实例：!EnableStgy(报警策略,1)，打开报警策略；!EnableStgy(报警策略,0)，关闭报警策略，使报警策略无效。
MCGS嵌入版运行环境操作函数
MCGS嵌入版运行环境操作函数运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时刻。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时刻。
实例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时刻改为5秒。
!CloseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开那个窗口，关闭其他窗口。
如果”WndName”为空串，则关闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloseAllWindow("工况图")，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloseAllWindow(" ")，关闭所有窗口。
!CloseAllSubWnd()函数意义：关闭窗口中的所有子窗口。
返回值：浮点型，=0为操作。
实例：!CloseAllSubWnd() ，关闭当前窗口的所有子窗口。
!CloseSubWnd（WndName）函数意义：关闭子窗口。
返回值：浮点型，=1为操作成功，<>1为操作失败。
参数值：WndName：子窗口的名字。
实例：!CloseSubWnd(窗口1)，关闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：SstgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。
实例：!EnableStgy(报警策略,1)，打开报警策略；!EnableStgy(报警策略,0)，关闭报警策略，使报警策略无效。
(环境管理)MCGS嵌入版运行环境操作函数
MCGS内部函数运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时间。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间。
实例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。
!CloseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，关闭其他窗口。
如果”WndName”为空串，则关闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloseAllWindow("工况图")，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloseAllWindow(" ")，关闭所有窗口。
!CloseAllSubWnd()函数意义：关闭窗口中的所有子窗口。
返回值：浮点型，=0为操作。
实例：!CloseAllSubWnd()，关闭当前窗口的所有子窗口。
!CloseSubWnd（WndName）函数意义：关闭子窗口。
返回值：浮点型，=1为操作成功，<>1为操作失败。
参数值：WndName：子窗口的名字。
实例：!CloseSubWnd(窗口1)，关闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：SstgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。
实例：!EnableStgy(报警策略,1)，打开报警策略；!EnableStgy(报警策略,0)，关闭报警策略，使报警策略无效。
MCGS嵌入版运行环境操作函数
MCGS嵌入版运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时间。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间。
实例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。
!CloeAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，关闭其他窗口。
如果”WndName”为空串，则关闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloeAllWindow(\工况图\，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloeAllWindow(\，关闭所有窗口。
!CloeAllSubWnd()函数意义：关闭窗口中的所有子窗口。
返回值：浮点型，=0为操作。
实例：!CloeAllSubWnd()，关闭当前窗口的所有子窗口。
!CloeSubWnd（WndName）函数意义：关闭子窗口。
返回值：浮点型，=1为操作成功，<>1为操作失败。
参数值：WndName：子窗口的名字。
实例：!CloeSubWnd(窗口1)，关闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。
实例：!EnableStgy(报警策略,1)，打开报警策略；!EnableStgy(报警策略,0)，关闭报警策略，使报警策略无效。
MCGS系统内部函数
函数意义：将数值型数据对象 x 的值转换成字符串。 返 回 值：字符型。 参 数：x, 数值型。 实 例：!Str(0.712) ="0.712"
5.3 窗口操作函数
!GetWindowState(WndName)
函数意义：按照名字取得用户窗口的状态。 返 回 值：数值型。
返回 0：用户窗口处于关闭状态。 返回 1：用户窗口处于打开状态。 返回 2：用户窗口处于隐藏状态。 参 数：WndName，用户窗口名称，字符型。 实 例：!GetWindowState(工况图)，读取用户窗口“工况图”的状态
5.6 事件操作函数
!GetEventdT(EvName)
函数意义：返回当前事件和上一次事件之间的时间差，单位为秒。 返 回 值：数值型。 参 数：EvName，事件变量名，字符型。 实 例：!GetEventdT(EvName)，取事件变量 EvName 当前事件和上一次事件之间的
时间差，单位为秒。
!Ltrim(str)
函数意义：把字符型数据对象 str 中最左边的空格剔除。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!LTrim(" dsfk ") = "dsfk "
!Rtrim(str)
函数意义：把字符型数据对象 str 中最右边的空格剔除。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!LTrim(" dsfk ") =" dsfk"
返 回 值：数值型。 参 数：str1, 字符型；
str2, 字符型。 实 例：!StrComp("ABC", "abc") = 0
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
数据中最早 1.2 小时内的数据。
!DelAllAlmDat(DatName)
函数意义：删除数据对象 DatName 对应的所有报警存储数据。如 DatName=空字符， 则删除所有对象对应的所有报警存储数据。
!GetWindowName(Index)
函数意义：按用户窗口的顺序获得用户窗口的名字。 返 回 值：字符型。 参 数：Index, 数值型。 实 例：!GetWindowName(0) ，读取 0 号用户窗口的名称。
!SetWindow(WndName,Op)
函数意义：按照名字操作用户窗口，如打开、关闭、打印。 返 回 值：数值型。返回值：=0：调用正常。<>0：调用不正常。
返 回 值：数值型，返回值=0：调用正常，<>0：调用不正常。 参 数：DatName：数据对象名，字符型。
FileName：新的报警存盘文件名(包括路径)，字符型。 Num1：数值型时间量，单位：小时。本函数用 Num1<0 的一些数值来表 示一些特殊意义的操作（此时 Num2 无效）： =-1 转存当天的所有报警信息存盘数据； =-2 转存昨天的所有报警信息存盘数据； =-3 转存本星期的所有报警信息存盘数据； =-4 转存上星期的所有报警信息存盘数据；
!GetDeviceName(Index)
函数意义：按设备顺序取到设备的名字。 返 回 值：字符型。调用成功返回设备名，调用失败时返回空字符串。 参 数：Index，数值型。 实 例：!GetDeviceName(0) ，取 0 号设备构件的名称。
5.5 策略操作函数
!GetStgyName(Index)
函数意义：应答数据对象 DataName 所产生的报警，如 DatName=空字符，则所有数据 对象所产生的报警。如对应的数据对象没有报警产生或已经应答，则本函 数无效。
返 回 值：无。 参 数：DatName：数据对象名，字符型； 实 例：!AnswerAlm(电机温度)，应答数据对象“电机温度”所产生的报警。
5.2 字符操作函数
!Left(str,n)
函数意义：字符型数据对象 str 左边起，取 n 个字符。 返 回 值：字符型。 参 数：str：字符型，源字符串；n，数值型，取字符个数。 实 例：!Left("ABCDEFG",2) ="AB"
!Right(str,n)
函数意义：从字符型数据对象 str 右边起，取 n 个字符。 返 回 值：字符型。 参 数：str，字符型，源字符串；n，数值型，取字符个数。 实 例：!Right("ABCDEFG",2) ="FG"
!Exp(x)
函数意义：指数函数。 返 回 值：数值型。 参 数：x，数值型。 实 例：!Exp(2.3020585093)=10.0
!Log(x)
函数意义：对数函数。 返 回 值：数值型。 参 数：x，数值型。 实 例：!Log(10)=2.302
!Sqr(x)
函数意义：平方函数。 返 回 值：数值型。 参 数：x，数值型。 实 例 ：!Sqr(2.0)=4.0
!Trim(str)
函数意义：把字符型数据对象 str 中左右两端的空格剔除。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!LTrim(" dsfk ") ="dsfk"
!StrComp(str1,str2)
函数意义：比较字符型数据对象 str1 和 str2 是否相等，返回值为 0 时相。等，否则不 相等。不分大小写字符。
!GetEventT(EvName)
函数意义：取到当前事件产生的时间，以秒为单位，相对于 1980 年以来的秒数。如没 有事件产生，返回-1。
返 回 值：数值型。 参 数：EvName，事件变量名，字符型。 实 例：!GetEventT(EvName)，取事件型变量 EvName 的当前事件产生时刻。
!DelAlmDat(DatName,Num)
函数意义：删除数据对象 DataName 对应的报警存储数据中最早 Num 小时内的报警存 储数据，如 Num<=0 或 DatName=空字符，则该函数无效。
返 回 值：数值型，返回值=0：调用正常，<>0：调用不正常。 参 数：DatName：数据对象名，字符型；
函数意义：按设备名查询设备的状态。 返 回 值：数值型。
=-1 调用不正常。 =1 设备处于正常的工作状态。 =2 设备正在工作，但设备不正常。 =3 设备处于停止工作状态，且设备正常。 =4 设备处于停止状态，且设备有错。 参 数：DevName，设备名，字符型。 实 例：!GetDeviceState( OmronPLC)，读取设备构件“OmronPLC”的当前工作状态。
5.6 事件操作函数
!GetEventdT(EvName)
函数意义：返回当前事件和上一次事件之间的时间差，单位为秒。 返 回 值：数值型。 参 数：EvName，事件变量名，字符型。 实 例：!GetEventdT(EvName)，取事件变量 EvName 当前事件和上一次事件之间的
时间差，单位为秒。
!GetEventP(EvName)
函数意义：取到当前事件的附加说明字符串。 返 回 值：字符型。 参 数：EvName，事件变量名，字符型。 实 例：!GetEventP(EvName) ，取事件型变量 EvName 的当前事件的附加说明字符
串。
5.7 报警操作函数
!AnswerAlm(DatName)
=-5 转存本月的所有报警信息存盘数据； =-6 转存上个月的所有报警信息存盘数据； Num2：数值型时间量，单位：小时。 Flag：转存标志，数值型。Flag=0 时，创建一个新文件(如原文件已存在， 则把原文件改名为***.BK1)；Flag=1 时，在原有的基础上增加新的数据。 实 例：!MoveAlmDat(电机温度, "D:\Temp\ttt.mdb"，-6，0，1)，把数据对象“电机 温度”对应的报警存盘数据中的上个月的所有报警信息存盘数据转存添加 到数据库文件当"D:\Temp\ttt.mdb"中。
参 数：WndName, 用户窗口名, 字符型。Op: 操作户窗口的方法，数值型。 Op=1：打开窗口并使其可见。 Op=2：打开窗口并使其不可见。 Op=3：关闭窗口。 Op=4：打印窗口。
实 例：!SetWindow(工况图,1)，打开用户窗口“工况图”，并使其可见。
5.4 设备操作函数
!GetDeviceState(DevName)
返 回 值：数值型。 参 数：str1, 字符型；
str2, 字符型。 实 例：!StrComp("ABC", "abc") = 0
!Val(str)
函数意义：把字符型数据对象 str 的值转换成数值。 返 回 值：数值型。 参 数：str, 字符型。 实 例：!Val("0.712") = 0.712
!Str(x)
函数意义：将数值型数据对象 x 的值转换成字符串。 返 回 值：字符型。 参 数：x, 数值型。 实 例：!Str(0.712) ="0.712"
5.3 窗口操作函数
!GetWindowState(WndName)
函数意义：按照名字取得用户窗口的状态。 返 回 值：数值型。
返回 0：用户窗口处于关闭状态。 返回 1：用户窗口处于打开状态。 返回 2：用户窗口处于隐藏状态。 参 数：WndName，用户窗口名称，字符型。 实 例：!GetWindowState(工况图)，读取用户窗口“工况图”的状态
第五章 MCGS 系统内部函数
MCGS 内部为用户提供了一些常用的数学函数和对 MCGS 内部有关对象操作的函数， 组态时，可在表达式中或用户脚本程序中直接使用这些函数。为了与其它名称相区别，系统 内部函数的名称一律以“！”符号开头。下面分别介绍各个函数的用途和用法。
5.1 数学函数
!Atn(x)
函数意义：反正切函数。 返 回 值：数值型，用弧度表示。 参 数：x，数值型。 实 例：!Atn(1) =0.785398
!Ltrim(str)
函数意义：把字符型数据对象 str 中最左边的空格剔除。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!LTrim(" dsfk ") = "dsfk "
!Rtrim(str)
函数意义：把字符型数据对象 str 中最右边的空格剔除。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!LTrim(" dsfk ") =" dsfk"
!Cos(x)
函数意义：余弦函数。 返 回 值：数值型。 参 数：x，数值型，用弧度表示。 实 例：!Cos(3.14159)=-1.0
!Sin(x)
函数意义：正弦函数。 返 回 值：数值型。 参 数：x，数值型，用弧度表示。 实 例：!Sin(3.14159)=0.0
!Tan(x)
函数意义：正切函数。 返 回 值：数值型。 参 数：x，数值型，用弧度表示。 实 例：!Tan(3.14159)=0.0
!Ucase(str)
函数意义：把字符型数据对象 str 的所有字符转换成大写。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!UCase("sedERT") ="SEDERT"
!Lcase(str)
函数意义：把字符型数据对象 str 的所有字符转换成小写。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!LCase("sedERT") = "sedert"