MCGS系统内部函数参考手册.docx
MCGS嵌入版参考手册资料

分参考手册另外,在主窗口的背景上,单击鼠标右键,弹出的右键菜单,与此菜单内容相同。
第十六章菜单详解16.1 概述MCGS嵌入版组态软件采用的是标准的菜单形式,合理的菜单结构设计以及完整的功能组合,使得用户可以使用菜单方便、快捷的组建工程。
下面开始详细的介绍各个菜单项的功能及其使用方法。
16.2 文件菜单“文件”菜单是一个下拉式菜单,它包括了对MCGS嵌入版工程文件的各种操作命令,其中有新文件的建立,文件的存盘,文件的打开、打印输出、打印预览等操作命令,还包括了检查组态结果和进入运行环境的操作命令。
下表中列出了“文件”菜单的各种操作命令。
菜单名图标对应快捷键功能说明新建工程Ctrl + N 新建并打开一个新的工程文件打开工程Ctrl + O 打开指定的工程文件关闭工程无关闭当前工程保存工程/保存窗口Ctrl + S 把当前工程存盘工程另存为无把当前工程以另外的名称存盘打印设置无设置打印配置打印预览无预览要打印的内容打印Ctrl + P 开始打印指定的内容组态结果检查F4 检查当前过程的组态结果是否正确进入运行环境F5 进入运行环境并运行当前工程生成安装盘无将当前工程生成安装盘退出系统无退出MCGS嵌入版的组态环境新建工程该项菜单命令是在工作目录中创建一个新的工程文件(安装时,工作目录缺省设置为:D:\MCGSE\WORK)。
新工程文件将以“新建工程×.MCE”来命名,此处的×为数字代码,如:新建工程0.MCE、新建工程1.MCE等。
新工程建立后,可以执行文件菜单中的“工程另存为”命令,重新命名工程文件和其工作目录。
菜单操作:文件| 新建工程工具条:快捷键:Ctrl + N打开工程执行该项操作命令后,MCGS嵌入版组态环境将弹出如下图所示的“打开文件”对话框。
在文件列表框中选定要打开的文件,或在“文件名(N)”编辑框中直接输入要打开的工程文件名称(含工作目录,如:d:\MCGSE\work\sample. mce),然后按“打开”按钮,就可以打开指定的工程。
MCGS嵌入版参考手册

16.2 文件菜单
“文件”菜单是一个下拉式菜单,它包括了对MCGS嵌入版工程文件的各种操作命令,其中有新文件的建立,文件的存盘,文件的打开、打印输出、打印预览等操作命令,还包括了检查组态结果和进“文件”菜单的各种操作命令。
分 参考手册
另外,在主窗口的背景上,单击鼠标右键,弹出的右键菜单,与此菜单内容相同。第十六章 菜单详解
16.1 概述
MCGS嵌入版组态软件采用的是标准的菜单形式,合理的菜单结构设计以及完整的功能组合,使得用户可以使用菜单方便、快捷的组建工程。下面开始详细的介绍各个菜单项的功能及其使用方法。
MCGS嵌入版参考手册

分参考手册另外,在主窗口的背景上,单击鼠标右键,弹出的右键菜单,与此菜单内容相同。
第十六章菜单详解概述MCGS嵌入版组态软件采用的是标准的菜单形式,合理的菜单结构设计以及完整的功能组合,使得用户可以使用菜单方便、快捷的组建工程。
下面开始详细的介绍各个菜单项的功能及其使用方法。
文件菜单“文件”菜单是一个下拉式菜单,它包括了对MCGS嵌入版工程文件的各种操作命令,其中有新文件的建立,文件的存盘,文件的打开、打印输出、打印预览等操作命令,还包括了检查组态结果和进入运行环境的操作命令。
下表中列出了“文件”菜单的各种操作命令。
打开工程Ctrl + O打开指定的工程文件关闭工程无关闭当前工程保存工程/保Ctrl + S把当前工程存盘存窗口把当前工程以另外的名称存工程另存为无盘打印设置无设置打印配置打印预览无预览要打印的内容打印Ctrl + P开始打印指定的内容检查当前过程的组态结果是组态结果检查F4否正确进入运行环境并运行当前工进入运行环境F5程生成安装盘无将当前工程生成安装盘退出系统无退出MCGS嵌入版的组态环境新建工程该项菜单命令是在工作目录中创建一个新的工程文件(安装时,工作目录缺省设置为:D:\MCGSE\WORK)。
新工程文件将以“新建工程×.MCE”来命名,此处的×为数字代码,如:新建工程、新建工程等。
新工程建立后,可以执行文件菜单中的“工程另存为”命令,重新命名工程文件和其工作目录。
文件 | 新建工菜单操作:程工具条:快捷键:Ctrl + N执行该项操作命令后,MCGS嵌入版组态环境将弹出如下图所示的“打开文件”对话框。
在文件列表框中选定要打开的文件,或在“文件名(N)”编辑框中直接输入要打开的工程文件名称(含工作目录,如:d:\MCGSE\work\sample. mce),然后按“打开”按钮,就可以打开指定的工程。
如果按“取消”按钮,将取消本次打开工程的操作。
菜单操作:文件| 打开工程工具条:快捷键:Ctrl + O选择关闭当前工程后,MCGS嵌入版组态环境将把当前工程文件保存到硬盘上,并退回到没有打开工程文件的状态下。
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
MCGS嵌入版参考手册资料

分参考手册另外,在主窗口的背景上,单击鼠标右键,弹出的右键菜单,与此菜单内容相同。
第十六章菜单详解16.1 概述MCGS嵌入版组态软件采用的是标准的菜单形式,合理的菜单结构设计以及完整的功能组合,使得用户可以使用菜单方便、快捷的组建工程。
下面开始详细的介绍各个菜单项的功能及其使用方法。
16.2 文件菜单“文件”菜单是一个下拉式菜单,它包括了对MCGS嵌入版工程文件的各种操作命令,其中有新文件的建立,文件的存盘,文件的打开、打印输出、打印预览等操作命令,还包括了检查组态结果和进入运行环境的操作命令。
下表中列出了“文件”菜单的各种操作命令。
菜单名图标对应快捷键功能说明新建工程Ctrl + N 新建并打开一个新的工程文件打开工程Ctrl + O 打开指定的工程文件关闭工程无关闭当前工程保存工程/保存窗口Ctrl + S 把当前工程存盘工程另存为无把当前工程以另外的名称存盘打印设置无设置打印配置打印预览无预览要打印的内容打印Ctrl + P 开始打印指定的内容组态结果检查F4 检查当前过程的组态结果是否正确进入运行环境F5 进入运行环境并运行当前工程生成安装盘无将当前工程生成安装盘退出系统无退出MCGS嵌入版的组态环境新建工程该项菜单命令是在工作目录中创建一个新的工程文件(安装时,工作目录缺省设置为:D:\MCGSE\WORK)。
新工程文件将以“新建工程×.MCE”来命名,此处的×为数字代码,如:新建工程0.MCE、新建工程1.MCE等。
新工程建立后,可以执行文件菜单中的“工程另存为”命令,重新命名工程文件和其工作目录。
菜单操作:文件| 新建工程工具条:快捷键:Ctrl + N打开工程执行该项操作命令后,MCGS嵌入版组态环境将弹出如下图所示的“打开文件”对话框。
在文件列表框中选定要打开的文件,或在“文件名(N)”编辑框中直接输入要打开的工程文件名称(含工作目录,如:d:\MCGSE\work\sample. mce),然后按“打开”按钮,就可以打开指定的工程。
MCGS嵌入版参考手册簿

分参考手册另外,在主窗口的背景上,单击鼠标右键,弹出的右键菜单,与此菜单容相同。
第十六章菜单详解16.1 概述MCGS嵌入版组态软件采用的是标准的菜单形式,合理的菜单结构设计以及完整的功能组合,使得用户可以使用菜单方便、快捷的组建工程。
下面开始详细的介绍各个菜单项的功能及其使用方法。
16.2 文件菜单“文件”菜单是一个下拉式菜单,它包括了对MCGS嵌入版工程文件的各种操作命令,其中有新文件的建立,文件的存盘,文件的打开、打印输出、打印预览等操作命令,还包括了检查组态结果和进入运行环境的操作命令。
下表中列出了“文件”菜单的各种操作命令。
新建工程该项菜单命令是在工作目录中创建一个新的工程文件(安装时,工作目录缺省设置为:D:\MCGSE\WORK)。
新工程文件将以“新建工程×.MCE”来命名,此处的×为数字代码,如:新建工程0.MCE、新建工程1.MCE等。
新工程建立后,可以执行文件菜单中的“工程另存为”命令,重新命名工程文件和其工作目录。
菜单操作:文件| 新建工程工具条:快捷键:Ctrl + N打开工程执行该项操作命令后,MCGS嵌入版组态环境将弹出如下图所示的“打开文件”对话框。
在文件列表框中选定要打开的文件,或在“文件名(N)”编辑框中直接输入要打开的工程文件名称(含工作目录,如:d:\MCGSE\work\sample. mce),然后按“打开”按钮,就可以打开指定的工程。
如果按“取消”按钮,将取消本次打开工程的操作。
菜单操作:文件| 打开工程工具条:快捷键:Ctrl + O关闭工程选择关闭当前工程后,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组态系统内部函数目录第一章数学函数 (6)!Atn(x) (6)!Arcsin(x) (6)!Arccos(x) (6)!Cos(x) (6)!Sin(x) (6)!Tan(x) (7)!Exp(x) (7)!Log(x) (7)!Sqr(x) (7)!Abs(x) (8)!Sgn(x) (8)!BitAnd(x,y) (8)!BitOr(x,y) (8)!BitXor(x,y) (8)!BitClear(x,y) (9)!BitSet(x,y) (9)!BitNot(x) (9)!BitTest(x,y) (9)!BitLShift(x,y) (9)!BitRShift(x) (10)!Rand(x,y) (10)第二章数据对象操作函数 (10)!AnswerAlm(DatName) (10)!ChangeDataSave(Datname,n) (10)!ChangeSaveDat(DatName,Num1,Num2) (11)!CopySaveDat(Tdb,Sdb,TabName,TimeField,Flag ) (11)!DelAllSaveDat(DatName) (11)!DelAllAlmDat(DatName) (12)!DelAlmDat(DatName,Num) (12)!DelSaveDat(DatName,Num) (12)!EnableAlm(name,n) (13)!EnableDataSave(name,n) (13)!GetAlmValue(DatName,Value,Flag) (13)!GetEventDT(EvName) (14)!GetEventP(EvName) (14)!GetEventT(EvName) (14)!MoveAlmDat(DatName,FileName,Num1,Num2,Flag) (14)!MoveSaveDat(DatName,FileName,Num1,Num2,Flag) (15)!SaveData(DatName) (16)!SaveDataInit() (16)!SaveDataOnTime(Time,TimeMS,DataName) (16)!SaveSingleDataInit(Name) (17)!SetAlmValue(DatName,Value,Flag) (17)第三章系统操作函数 (18)!AppActive(Title) (18)!Beep() (18)!EnableDDEConnection(DatName,n) (18)!EnableDDEInput(DatName,n) (19)!EnableDDEOutput (DatName,n) (19)!LinePrtOutput (str) (19)!PlaySound(SndFileName,Op) (19)!SendKeys(string) (20)!SetLinePrinter(n) (22)!SetTime(n1,n2,n3,n4,n5,n6) (23)!Shell(pathname,windowstyle) (23)!Sleep(mTime) (24)!TerminateApplication(AppName,Timeout) (24)!WaitFor (Dat1,Dat2) (24)!WinHelp(HelpFileName,uCommand,dwData) (25)!Navigate(WebAddress) (25)!DDEReconnect( ) (26)!ShowDataBackup( ) (26)第四章字符串操作函数 (26)!Ascii2I(s) (26)!Bin2I(s) (26)!Format(n,str) (26)!Hex2I(s) (27)!I2Ascii(s) (27)!I2Bin(s) (27)!I2Hex(s) (27)!I2Oct(s) (28)!InStr(n,str1,str2) (28)!Lcase(str) (28)!Left(str,n) (28)!Len(Str) (29)!Ltrim(str) (29)!lVal(str) (29)!Mid(str,n,k) (29)!Oct2I(s) (30)!Right(str,n) (30)!Rtrim(str) (30)!Str(x) (30)!StrFormat(FormatStr,任意个数变量) (31)!Trim(str) (31)!Ucase(str) (31)!Val(str) (31)第五章运行环境操作函数 (32)!CallBackSvr(DatName) (32)!ChangeLoopStgy(StgyName,n) (32)!CloseAllWindow(WndName) (32)!EnableStgy(StgyName,n) (33)!GetDeviceName(Index) (33)!GetDeviceState(DevName) (33)!GetStgyName(Index) (34)!GetWindowName(Index) (34)!GetWindowState(WndName) (34)!SetActiveX(Activename,n,str) (34)!SetDevice(DevName,DevOp,CmdStr) (35)!SetStgy(StgyName) (35)!SetWindow(WndName,Op) (35)!SysWindow() (36)!DisableCtrlAltDel() (36)!EnableCtrlAltDel() (36)!RestartProject() (37)第六章用户登录操作函数 (37)!ChangePassword() (37)!CheckUserGroup(strUserGroup) (37)!Editusers() (37)!EnableExitLogon(n) (38)!EnableExitPrompt (n) (38)!GetCurrentGroup() (38)!GetCurrentUser() (38)!LogOff() (39)!LogOn() (39)!GetUserNameByIndex() (39)!GetGroupNameByIndex() (39)!GetProjectTotalUsers () (39)第七章文件操作函数 (40)!FileAppend(strTarget ,strSource) (40)!FileCopy(strSource ,strTarget) (40)!FileDelete(strFilename) (40)!FileFindFirst(strFilename,objName,objSize,objAttrib) (41)!FileFindNext(FindHandle,objName,objSize,objAttrib) (41)!FileIniReadValue(strIniFilename,strSection,strItem,objResult) (42)!FileIniWriteValue(strIniFilename,strSection,strItem,objResult) (42)!FileMove(strSource,strTarget) (43)!FileReadFields(strFilename,lPosition,任意个数变量) (43)!FileSplit(strSourceFile,strTargetFile, FileSize) (44)!FileWriteFields(strFilename,lPosition,任意个数变量) (44)!FileWriteStr(strFilename,lPosition,str,Rn) (45)第八章ODBC数据库函数 (45)!ODBCOpen(strDatabastName,strSQL,strName) (45)!ODBCSeekToPosition(strName,lPosition) (46)!ODBCClose(strName) (46)!ODBCConnectionCloseAll() (47)!ODBCConnectionCount() (47)!ODBCConnectionGetName(lID) (47)!ODBCDelete(strName) (47)!ODBCEdit(strName) (48)!ODBCExecute(strName,strSQL) (48)!ODBCGetCurrentValue(strName) (49)!ODBCGetRowCount(strName) (49)!ODBCIsBOF(strName) (49)!ODBCIsEOF(strName) (50)!ODBCMoveFirst(strName) (50)!ODBCMoveLast(strName) (50)!ODBCMoveNext(strName) (51)!ODBCMovePrev(strName) (51)!ODBCBind(strName,任意个数变量) (51)!ODBCAddnew(strName) (52)第九章配方操作函数 (52)!RecipeLoad(strFilename ,strRecipeName) (52)!RecipeMoveFirst(strRecipeName) (53)!RecipeMoveLast(strRecipeName) (53)!RecipeMoveNext(strRecipeName) (53)!RecipeMovePrev(strRecipeName) (54)!RecipeSave(strRecipeName,strFilename) (54)!RecipeSeekTo(strRecipeName,DataName,str) (54)!RecipeSeekToPosition(strRecipeName,rPosition) (55)!RecipeSort(strRecipeName,DataName,Num) (55)!RecipeClose(strRecipeName) (56)!RecipeDelete(strRecipeName) (56)!RecipeEdit(strRecipeName) (56)!RecipeGetCount(strRecipeName) (57)!RecipeGetCurrentPosition(strRecipeName) (57)!RecipeGetCurrentValue(strRecipeName) (57)!RecipeInsertAt(strRecipeName,rPosition) (58)!RecipeBind(strRecipeName,任意个数变量) (58)!RecipeAddNew(strRecipeName) (59)第十章时间运算函数 (59)!TimeStr2I(strTime) (59)!TimeI2Str(iTime,strFormat) (59)!TimeGetYear(iTime) (61)!TimeGetMonth(iTime) (62)!TimeGetSecond(iTime) (62)!TimeGetSpan(iTime1,iTime2) (62)!TimeGetDayOfWeek(iTime) (62)!TimeGetHour(iTime) (63)!TimeGetMinute(iTime) (63)!TimeGetDay(iTime) (63)!TimeGetCurrentTime() (63)!TimeSpanGetDays(iTimeSpan) (64)!TimeSpanGetHours(iTimeSpan) (64)!TimeSpanGetMinutes(iTimeSpan) (64)!TimeSpanGetSeconds(iTimeSpan) (65)!TimeSpanGetTotalHours(iTimeSpan) (65)!TimeSpanGetTotalMinutes(iTimeSpan) (65)!TimeSpanGetTotalSeconds(iTimeSpan) (65)!TimeAdd(iTime,iTimeSpan) (66)第十一章定时器操作函数 (66)!TimerClearOutput(定时器号) (66)!TimerRun(定时器号) (66)!TimerStop(定时器号) (66)!TimerSkip(定时器号,步长值) (67)!TimerReset(定时器号,数值) (67)!TimerValue(定时器号,0) (67)!TimerStr(定时器号,转换类型) (67)!TimerState(定时器号) (68)!TimerSetLimit(定时器号,上限值,参数3) (68)!TimerSetOutput(定时器号,数值型变量) (68)!TimerWaitFor(定时器号,数值) (68)第十二章MCGS系统变量 (69)$Year (69)$Month (69)$Day (69)$Hour (69)$Minute (69)$Second (70)$Week (70)$Date (70)$Time (70)$Timer (70)$RunTime (70)$PageNum (71)$UserName (71)第十三章存盘服务对象 (71)方法:SetStartPos (71)方法:GetDat (71)第一章数学函数 !Atn(x)函数意义:反正切函数。
MCGS嵌入版参考手册

MCGS嵌入版参考手册分参考手册另外,在主窗口的背景上,单击鼠标右键,弹出的右键菜单,与此菜单内容相同。
第十六章菜单详解16.1详述mcgs嵌入版组态软件采用的是标准的菜单形式,合理的菜单结构设计以及完整的功能组合,使得用户可以使用菜单方便、快捷的组建工程。
下面开始详细的介绍各个菜单项的功能及其使用方法。
16.2文件菜单“文件”菜单是一个下拉式菜单,它包括了对mcgs嵌入版工程文件的各种操作命令,其中有新文件的建立,文件的存盘,文件的打开、打印输出、打印预览等操作命令,还包括了检查组态结果和进入运行环境的操作命令。
下表中列举了“文件”菜单的各种操作命令。
菜单名新建工程关上工程停用工程留存工程/留存窗口工程另存为列印设置列印预览列印组态结果检查步入运转环境分解成安装盘选择退出系统图标对应快捷键ctrl+nctrl+o无ctrl+s无无无ctrl+pf4f5无无功能表明新建并关上一个代莱工程文件关上选定的工程文件停用当前工程把当前工程计算机上安装把当前工程以另外的名称计算机上安装设置列印布局预览必须列印的内容已经开始列印选定的内容检查当前过程的组态结果与否恰当步入运转环境并运转当前工程将当前工程分解成安装盘选择退出mcgs内嵌版的组态环境新建工程该项菜单命令是在工作目录中创建一个新的工程文件(安装时,工作目录缺省设置为:d:\\mcgse\\work)。
新工程文件将以“新建工程×.mce”来命名,此处的×为数字代码,如:新建工程0.mce、新建工程1.mce等。
崭新工程创建后,可以继续执行文件菜单中的“工程另存为”命令,重新命名工程文件和其工作目录。
菜单操作:工具条:快捷键:文件|新建工程ctrl+n打开工程继续执行该项操作命令后,mcgs内嵌版组态环境将插入如下图右图的“关上文件”对话框。
在文件列表框中选定要打开的文件,或在“文件名(n)”编辑框中直接输入要打开的工程文件名称(含工作目录,如:d:\\mcgse\\work\\sample.mce),然后按“打开”按钮,就可以打开指定的工程。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
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时表示关闭此策略。
实例:!EnableStgy(报警策略,1),打开报警策略;!EnablcStgy(报警策略,0),关闭报警策略,使报警策略无效! GetDe viceN ame(lndex)函数意义:按设备顺序取到设备的名字。
返回值:字符型。
调用成功返回设备名,调用失败时返回空字符吊。
参数:Index,数值型。
实例:IGetDeviceName(0),取0号设备构件的名称。
IGetDeviceState(DevName)函数意义:按设备名查询设备的状态。
返回值:数值型。
=-1调用不止常。
=1设备处于止常的工作状态。
=2设备正在工作,但设备不正常。
=3设备处于停止工作状态,且设备止常。
=4设备处于停止状态,且设备有错。
参数:DevName,设备名,字符型。
实例:!GetDeviceState( OmronPLC),读取设备构件a OmronPLC的当前工作状态。
!GetStgyName(Index)函数意义:按运行策略的顺序获得各策略块的名字。
返回值:字符型。
参数:Index,数值型。
实例:!GetStgyName(0),取0号运行策略的名称。
IGetWindowName(Index)函数意义:按用户窗口的顺序获得用户窗口的名字。
返回值:字符型。
参数:Index,数值型。
实例:!GetWindowName(0),读取0号用户窗口的名称。
!GetWindowState(WndName)函数意义:按照名字取得用户窗口的状态。
返回值:数值型。
返回0:用户窗口处于关闭状态。
返回1:用户窗口处于打开状态。
返冋2:用户窗口处于隐藏状态。
参数:WndName,用户窗口名称,字符型。
实例:!GctWindowState(工况图),获得用户窗口“工况图”的状态!SetActiveX(Activename, n, str)函数意义:操作指定的动画构件,向窗口中的ActiveX控件发出控件命令返回值:无参数:Activcname,字符型,控件名称,用”分割窗口名和控件名,如:窗口0.控件1表示在用户窗口“窗口0”中的名为“控件1”的控件。
n,数值型,命令类型,请填1;str,字符型,命令字符吊,具体含义请参照控件帮助。
实例:!SetActiveX( “窗口0•控件0”,1, ” start” ),启动窗口0 的控件0 开始工作。
!SetDevice(DevName, DevOp, CmdStr)函数意义:按照设备名字对设备进行操作。
返回值:数值型。
返回值:二0:调用正常;〈>0:调用不正常。
参数:DevNamc,设备名,字符型;DevOp,设备操作码,数值型;CmdStr,设备命令字符串,只有当Dcv0p=6时CmdStr才有意义。
DcvOp取值范围及相应含义:1:启动设备开始工作。
2:停止设备的工作使其处于停止状态。
3:测试设备的工作状态。
4:启动设备工作一次。
5:改变设备的工作周期,CmdStr中包含新的工作周期,单位为ms。
6:执行指定的设备命令,CmdStr中包含指定命令的格式。
实例:!SetDevice(OmronPLC, 1, z,z,),启动设备构件“OnwonPLC” 开始工作。
ISetStgy(StgyName)函数意义:执行StgyName指定的运行策略。
返回值:数值型。
返冋值二0:调用正常;<>0:调用不正常。
参数:StgyName,策略名,字符型。
实例:!SctStgy(阀门关闭),执行一次运行策略“阀门关闭”。
!SetWindow(WndName, Op)函数意义:按照名字操作用户窗口,如打开、关闭、打卬。
返回值:数值型。
返回值:二0:调用正常;〈>0:调用不正常。
参数:WndName,用户窗口名,字符型。
Op:操作用户窗口的方法,数值型。
Op=l:打开窗口并使其可见。
Op=2:打开窗口并使其不可见。
Op=3:关闭窗口。
0p=4:打印窗口。
Op=5:刷新窗口。
实例:!SetWindow(I况图,1),打开用户窗口“工况图”,并使其可见。
!SysWindow()函数意义:执行该函数后,打开用户窗口管理窗口,在管理窗口中可以选择打开或关闭指定的用户窗口。
返回值:数值型。
返回值二0:调用成功;〈〉0:调用失败。
参数:无。
实例:!SysWindow()!DisableCtrlAltDel()函数意义:屏蔽热键Ctrl+Alt+Del的功能。
无法打开任务管理器窗口或执行锁定计算机、注销、关机、密码修改等操作。
返回值:数值型。
返回值二0:调用成功;〈〉0:调用失败。
参数:无。
实例:IDisableCtrlAltDel ()注意此函数在网络版客户端和WIN98操作系统下无效。
!EnabIeCtrIAltDel()函数意义:恢复热键Ctrl+Alt+Del的功能。
使用任务管理器关闭不响应的程序或执行锁定计算机、注销、关机、修改密码等,为了维护系统安全的操作。
返回值:数值型。
返回值二0:调用成功;〈>0:调用失败。
参数:无。
实例:!EnableCtrlAltDel()注意:1・不要把这两个脚本函数同时使用,否则,看不到任何效果,没有任何意义;2.不要把这两个函数放到循环中使用;3.在使用这2个脚本函数时,最好与登录密码同时使用,以达到真止的热键屏蔽效果。
4.此函数在网络版客户端和WIN98操作系统卜•无效。
!RestartProject()函数意义:当检查组态工程在运行过程中出现非正常状态,叮以调用该函数重新启动运行环境。
该功能必须在加密狗生效时方可工作。
返回值:无。
参数:无。
实例:! RestartProject ()数据对象操作函数!AnswerAlm(DatName)函数意义:应答数据对象DatName所产生的报警。
如对应的数据对象没有报警产生或已经应答,则木函数无效。
返回值:数值型,二0为操作成功;〈〉0为操作失败。
参数:DatName,数据对象名;实例:! Answer Alm (Ffe机温度),应答数据对象“电机温度”所产生的报警。
!ChangeDataSave(Datname, n)函数意义:改变数据对象Datname存盘的周期。
返回值:数值型,二0为操作成功;〈〉0为操作失败。
参数:Datname,数据对象名;n,数值型,以秒表示的存盘间隔时间实例:ChangcDataSavc(温度,5),温度的存盘间隔时间为5秒!ChangeSaveDat(DatName, Numl, Num2)函数意义:改变数据对象DatName所对应存盘数据的存盘间隔,把Numl小时以前的存盘数据(以当前时间为0点)的存盘间隔改为Nuni2秒。
本操作只对组对象有效,对单个的数据对象无效。
当DataNamc二空字符,或Num 1=0或Num2二0 时,本操作无效。
返回值:数值型,返回值二0:调用正常;〈>0:调用不正常。
参数:DatNamc:数据对象名。
Numl:数值型时间量,单位:小时。
本函数用Numl<0的一些数值來表示一些特殊意义的操作:=-1改变当天对应数据对象所有存盘数据的存盘间隔;=-2改变昨天对应数据对象所有存盘数据的存盘间隔;=-3改变木星期对应数据对象所有存盘数据的存盘间隔;=-4改变上星期对应数据对象所有存盘数据的存盘间隔;=-5改变本月对应数据对象所有存盘数据的存盘间隔;=-6改变上个月对应数据对象所有存盘数据的存盘间隔;Num2:数值型时间量,新的存盘间隔,单位:秒。
实例:!ChangeSaveDat(电机1, -2, 5),把组对象“电机1”对应的存盘数据中昨天的存盘数据的存盘间隔改为5秒钟。
!CopySaveDat(Tdb,Sdb,TabName,TimeField,Flag)函数意义:拷贝数据库中数据表的数据返回值:开关型,返回值二0:调用正常;返回值〈〉0:调用不正常。
参数:Tdb,目标数据库名;Sdb,源数据库名;TabNamc,数据表名;TimcFicld,定义的时间字段名;Flag,拷贝方式,0:覆盖拷贝;1:添加拷贝。
实例:!CopySaveDat (Tdb, Sdb, TabName, TimeField, 0),将数据库Sdb 中表TabNamc中的数据拷贝到数据库Tdb中,表名仍是TabName,定义的时间字段为TimcFicld,拷贝方式为覆盖拷贝。
!DelAllSaveDat(DatName)函数意义:删除数据对象DatNamc对应的所有存盘数据。
返回值:数值型,返回值二0:调用正常;〈>0:调用不正常。
参数:DatName,数据对象名。
实例:!DelAllSavcDat(电机温度),删除数据对象“电机温度”对应的所有存盘数据。
IDelAllAlmDat (DatName)函数意义:删除数据对象DataName对应的所有报警存盘数据。