MCGS嵌入版运行环境操作函数

1、MCGS内部函数运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循循环策略略的循环环时间。返 回 值值：数值值型。返返回值=0：调调用正常常，0：调调用不正正常。参 数：StggyNaame，策策略名；n，数值型型，以毫毫秒数表表示循环环策略的的循环时时间。实 例：!ChhanggeLooopSStgyy(报警警策略,50000)，将将报警策策略的循循环时间间改为55秒。!ClosseAlllWiindoow(WWndNNamee)函数意义：关闭所所有窗口口，如果果在字符符串”WWndNNamee”中指指定了一一个窗口口，则打打开这个个窗口，关关闭其他他窗口

2、。如如果”WWndNNamee”为空空串，则则关闭所所有窗口口。返 回 值值：数值值型。返返回值：=0：调用正正常。0：调用不不正常。参 数：WnddNamme， 用户窗窗口名，字字符型。实 例：!ClloseeAlllWinndoww(工工况图)，关关闭除了了用户窗窗口“工况图图”以外的的其他窗窗口，若若“工况图图”窗口没没有打开开，则在在关闭其其他窗口口的同时时打开该该窗口；!ClosseAlllWiindoow( )，关闭闭所有窗窗口。!ClosseAlllSuubWnnd()函数意义：关闭窗窗口中的的所有子子窗口。返 回 值值：浮点点型，=0为操操作。实 例：!ClloseeAlllS

3、ubbWndd() ，关闭闭当前窗窗口的所所有子窗窗口。!ClosseSuubWnnd（WnddNamme）函数意义：关闭子子窗口。返 回 值值：浮点点型，=1为操操作成功功，1为操操作失败败。参 数 值值：WnddNamme：子子窗口的的名字。实 例：!ClloseeSubbWndd(窗口口1)，关关闭子窗窗口“窗口11”。!EnabbleSStgyy(SttgyNNamee,n)函数意义：打开或或关闭某某个策略略，如报报警策略略或循环环策略等等。返 回 值值：数值值型。返返回值=0：调调用正常常，0：调调用不正正常。参 数：SSstggyNaame，策策略名；n，数值型型，为11时表示示打

4、开此此策略，为为0时表表示关闭闭此策略略。实 例：!EnnablleSttgy(报警策策略,11)， 打开报报警策略略；!EnabbleSStgyy(报警警策略,0)， 关闭报报警策略略，使报报警策略略无效。!GetDDeviiceNNamee(Inndexx)函数意义：按设备备顺序取取到设备备的名字字。返 回 值值：字符符型。调调用成功功返回设设备名，调调用失败败时返回回空字符符串。参 数：Inddex，数数值型。实 例：!GeetDeevicceNaame(0) ，取00号设备备构件的的名称。!GetDDeviiceSStatte(DDevNNamee)函数意义：按设备备名查询询设备的的状

5、态。返 回 值值：数值值型。=-1调用用不正常常。=1 设备备处于正正常的工工作状态态。=2 设备备正在工工作，但但设备不不正常。=3 设备备处于停停止工作作状态，且且设备正正常。=4 设备备处于停停止状态态，且设设备有错错。参 数：DevvNamme，设设备名，字字符型。实 例：!GeetDeevicceSttatee(OmmronnPLCC)，读读取设备备构件“OOmroonPLLC”的的当前工工作状态态。注 意：设设备名称称是在设设备构件件基本属属性页中中设置的的。!GetLLasttMouuseAActiionTTimee()函数意义：获取最最后一次次鼠标的的动作发发生的时时间。返 回

6、 值值：开关关型。返返回为ttimee_t类类型的时时间值，可可以在时时间操作作脚本函函数中使使用。参 数：无无。实 例：在在画面，系系统对话话框上的的鼠标事事件中添添加!GGetLLasttMouuseAActiionTTimee()，获获取鼠标标最后动动作时间间。!GetSStgyyNamme(IIndeex)函数意义：按运行行策略的的顺序获获得各策策略块的的名字。返 回 值值：字符符型。参 数：Inddex，数数值型。实 例：!GeetSttgyNNamee(0)，取00号运行行策略的的名称。!GetWWinddowNNamee(Inndexx)函数意义：按用户户窗口的的顺序获获得用户户

7、窗口的的名字。返 回 值值：字符符型。参 数：Inddex， 数值型型。实 例：!GeetWiindoowNaame(0) ，读取取0号用用户窗口口的名称称。!GetWWinddowSStatte(WWndNNamee)函数意义：按照名名字取得得用户窗窗口的状状态。返 回 值值：数值值型。返回0：用用户窗口口处于关关闭状态态。返回1：用用户窗口口处于打打开状态态。返回2：用用户窗口口处于隐隐藏状态态。参 数：WnddNamme，用用户窗口口名称，字字符型。实 例：!GeetWiindoowSttatee(工况况图)，获得得用户窗窗口“工况图图”的状态态。!OpennSubbWndd（参数数1,

8、参数数2，参数数3，参数数4，参数数5，参数数6）函数意义：显示子子窗口。返回值：字字符型，如如成功就就返回子子窗口nn，n表示打打开的第第n个子窗窗口。参数值：参参数1：要打打开的子子窗口名名。参数2：整整型，打打开子窗窗口相对对于本窗窗口的XX坐标。参数3：整整型，打打开子窗窗口相对对于本窗窗口的YY坐标。参数4：整整型，打打开子窗窗口的宽宽度。参数5：整整型，打打开子窗窗口的高高度。参数6：整整型，打打开子窗窗口的类类型。0位：是否否模式打打开，使使用此功功能，必必须在此此窗口中中使用CClosseSuubWnnd来关关闭本子子窗口，子子窗口外外别的构构件对鼠鼠标操作作不响应应1位：是否

9、否菜单模模式，使使用此功功能，一一旦在子子窗口之之外按下下按钮，则则子窗口口关闭。2位：是否否显示水水平滚动动条，使使用此功功能，可可以显示示水平滚滚动条3位：是否否垂直显显示滚动动条，使使用此功功能，可可以显示示垂直滚滚动条4位：是否否显示边边框，选选择此功功能，在在子窗口口周围显显示细黑黑线边框框5位：是否否自动跟跟踪显示示子窗口口，选择择此功能能，在当当前鼠标标位置上上显示子子窗口。此此功能用用于鼠标标打开的的子窗口口，选用用此功能能则忽略略iLeeft,iToop的值值，如果果此时鼠鼠标位于于窗口之之外，则则在窗口口对中显显示子窗窗口6位：是否否自动调调整子窗窗口的宽宽度和高高度为缺缺

10、省值，使使用此功功能则忽忽略iWWidtth和iHeeighht的值值。子窗口的关关闭办法法：使用关闭窗窗口直接接关闭，则则把整个个系统中中使用到到的此子子窗口完完全关闭闭使用指定窗窗口的CClosseSuubWnnd关闭闭，可以以使用OOpennSubbWndd返回的的控件名名，也可可以直接接指定子子窗口关关闭，此此时只能能关闭此此窗口下下的子窗窗口。!SetAActiiveXX()函数说明：此函数数在嵌入入版中无无效，考考虑兼容容性问题题，故保保留。!CalllBacckSvvr()函数说明：此函数数在嵌入入版中无无效，考考虑兼容容性问题题，故保保留。!SetDDeviice(DevvNa

11、mme,DDevOOp,CCmdSStr)函数意义：按照设设备名字字对设备备进行操操作。返 回 值值：数值值型。返返回值：=0：调用正正常。0：调用不不正常。参 数：DevvNamme，设设备名，字字符型；DevOpp，设备备操作码码，数值值型；CmdSttr，设设备命令令字符串串，只有有当DeevOpp=6时时CmddStrr才有意意义。DevOpp取值范范围及相相应含义义：1：启动设设备开始始工作。2：停止设设备的工工作使其其处于停停止状态态。3：测试设设备的工工作状态态。4：启动设设备工作作一次。5：改变设设备的工工作周期期，CmmdSttr中包包含新的的工作周周期，单单位为mms。6：

12、执行指指定的设设备命令令，CmmdSttr中包包含指定定命令的的格式。实 例：!SeetDeevicce(OOmroonPLLC,11, )，启动动设备构构件“OOmroonPLLC”开开始工作作。!SetMMoussePaace(开关型型)函数意义：设置鼠鼠标灵敏敏度。参 数：开开关型参参数为每每次按键键消息需需要设置置的鼠标标移动间间隔，一一般情况况下请输输入正整整数，如如果输入入0值表表示禁止止该功能能实 例：!SeetMoouseePacce(11); 默认情况下下该功能能为关闭闭状态，鼠鼠标灵敏敏度为00，如果果想启用用该功能能在启动动策略中中调用!SettMouusePPacee脚

13、本函函数指定定步长值值。 !SetNNumPPaneelSiize(Typpe,SSizee)函数意义：根据需需要和显显示屏的的大小调调整软键键盘的大大小。返 回 值值：开关关型。返回值=00：修改改成功。新新设置将将在下一一次打开开输入键键盘时生生效。返回值=11：修改改失败，参参数错误误。（可可能是没没有匹配配的tyype ，或者者sizze参数数超出范范围）。参 数：Typpe，键键盘类型型，数值值型；1：代表修修改数值值输入键键盘。2：代表修修改字符符输入键键盘；。3：代表修修改用户户登录对对话框。Size，键键盘大小小，数值值型；数数值范围围：2000像素素10024像像素；实 例：

14、!SeetNuumPaanellSizze(11,5000)，将将数值输输入键盘盘改为5500*5000大小，该该正方形形相对于于屏幕居居中。所所有修改改将在下下一次打打开输入入框时生生效，运运行环境境退出后后，将自自动保留留上次输输入框的的大小。注意事项：键盘放放大缩小小功能在在重新下下载工程程时没有有删除配配置文件件，换工工程后设设置仍然然有效，除除非重新新进行了了设置。如如果要去去掉原来来的设置置则需要要手工删删除paanellSizze.iini文文件，该该文件位位于hhardddisskmmcgssbinn目录下下。 !SetSStgyy(SttgyNNamee)函数意义：执行Stt

15、gyNNamee指定的的运行策策略。返 回 值值：数值值型。返返回值=0：调调用正常常，0：调调用不正正常。参 数：StggyNaame，策策略名，字字符型。实 例：!SeetSttgy(阀门关关闭)，执行行一次运运行策略略“阀门关关闭”。!SetWWinddow(WnddNamme,OOp)函数意义：按照名名字操作作用户窗窗口，如如打开、关关闭、打打印。返 回 值值：数值值型。返返回值：=0：调用正正常。0：调用不不正常。参 数：WnddNamme， 用户窗窗口名， 字符型型。Opp: 操操作用户户窗口的的方法，数数值型。Op=1：打开窗窗口并使使其可见见。Op=2：打开窗窗口并使使其不可可

16、见。Op=3：关闭窗窗口。Op=4：打印窗窗口。Op=5：刷新窗窗口。实 例：!SeetWiindoow(工工况图,1)，打打开用户户窗口“工况图图”，并使使其可见见。!SysWWinddow()函数意义：执行该该函数后后，打开开用户窗窗口管理理窗口，在在管理窗窗口中可可以选择择打开或或关闭指指定的用用户窗口口。返 回 值值：数值值型。返返回值=0：调调用成功功；0：调调用失败败。参 数：无无。实 例：!SyysWiindoow()。!SetSStyMModee(SttgyNNamee)函数意义：通过脚脚本函数数（位于于系统函函数-运运行环境境类）实实现函数数调用方方式的策策略调用用。返回 值

17、：开关型型，返回回值恒为为0。参 数：StggyNaame，策策略名，字字符型。实 例：!SeetSttgyMModee(阀门门关闭)，执行行一次运运行策略略“阀门关关闭”，“阀门关关闭”策略执执行完毕毕后，才才返回调调用者，调调用者继继续执行行以下程程序。!GetCCurrrenttLannguaageIIndeex( ) 函数意义：用于获获取当前前使用的的语言的的索引值值。 返 回 值值：开关关型。返返回值为为语言项项索引值值。 索索引值按按照组态态下拉框框依次排排序0，11，2参 数： 无。 实 例：NN=!GGetCCurrrenttLannguaageIIndeex( ) ，其其中N

18、为为开关型型变量 。 !SetCCurrrenttLannguaageIIndeex ( 开关关型 ) 函数意义：通过索索引项设设定当前前语言环环境 返 回 值值：开关关型。返返回值为为0表示示执行成成功，否否则表示示失败。 参 数：开开关型。语语言索引引值。如如果索引引参数值值超出当当前选择择语言范范围，那那么函数数不生效效。 实 例：!SettCurrrenntLaanguuageeInddex(1)，表表示设置置当前语语言为英英文（选选择语言言为CHH，ENN）。 !GetLLocaalLaanguuageeStrr( 开开关型 ) 函数意义：获得指指定自定定义IDD对应的的当前语语言的

19、内内容。 返 回 值值：字符符型。 参 数：开开关型。自自定义IID索引引值。如如果无当当前IDD对应自自定义文文本，则则返回空空值。 实 例：!GettLoccalLLangguaggeSttr（22），前前提是有有ID为为2的自自定义文文本内容容，如果果当前语语言为英英文，则则返回IID为22的自定定义文本本记录的的英文内内容。 !GetLLangguaggeNaameBByInndexx(开关关型) 函数意义：根据语语言索引引值返回回语言名名称，返返回值为为字符型型。返 回 值值：字符符型，当当前语言言的名称称。 参 数：开开关型。语语言的索索引值。如如果当前前索引值值无对应应语言，则则

20、返回空空值。 实 例：!GettLannguaageNNameeByIIndeex(11) ，假假如当前前语言为为中文、英英文，则则返回值值为Enngliish。数据对象操操作函数数!AnswwerAAlm(DattNamme)函数意义：应答数数据对象象DattNamme所产产生的报报警。如如对应的的数据对对象没有有报警产产生或已已经应答答，则本本函数无无效。返回值：数数值型，=0为操作成功，0为操作失败。参 数：DattNamme，数数据对象象名。实 例：!AnnsweerAllm(电电机温度度)，应答答数据对对象“电机温温度”所产生生的报警警。!ChanngeDDataaSavve(DDa

21、tnnamee,n)函数意义：改变数数据对象象Dattnamme存盘盘的周期期。返回值：数数值型，=0为操作成功，0为操作失败。参 数：Dattnamme，数数据对象象名；nn，数值值型，以以秒表示示的存盘盘间隔时时间。实 例：!ChhanggeDaataSSavee(温度度,5)，温度的的存盘间间隔时间间为5秒。!ChanngeSSaveeDatta(DDatNNamee,Nuum1,Numm2)该函数在通通用版中中可以使使用，在在嵌入版版中不能能使用！函数意义：改变数数据对象象DattNamme所对对应存盘盘数据的的存盘间间隔，把把Numm1小时时以前的的存盘数数据（以以当前时时间为00点

22、）的的存盘间间隔改为为Numm2秒。本本操作只只对组对对象有效效，对单单个的数数据对象象无效。当当DattaNaame =空字字符，或或Numm1=00或Numm2=00时，本本操作无无效。返回值：数数值型，返返回值=0：调调用正常常，0：调调用不正正常。参 数：DattNamme：数数据对象象名。Num1：数值型型时间量量，单位位：小时时。本函函数用NNum110的的一些数数值来表表示一些些特殊意意义的操操作：=-1 改改变当天天对应数数据对象象所有存存盘数据据的存盘盘间隔；=-2 改改变昨天天对应数数据对象象所有存存盘数据据的存盘盘间隔；=-3 改改变本星星期对应应数据对对象所有有存盘数数

23、据的存存盘间隔隔；=-4 改改变上星星期对应应数据对对象所有有存盘数数据的存存盘间隔隔；=-5 改改变本月月对应数数据对象象所有存存盘数据据的存盘盘间隔；=-6 改改变上个个月对应应数据对对象所有有存盘数数据的存存盘间隔隔；Num2：数值型型时间量量，新的的存盘间间隔，单单位：秒秒。实 例：!ChhanggeSaaveDDataa(电机机1,-2,55)，把把组对象象“电机1”对应应的存盘盘数据中中昨天的的存盘数数据的存存盘间隔隔改为55秒钟。!FlusshDaataIInittVallueTToDiisk()函数意义：把所有有数据对对象的初初始值写写入磁盘盘。返回值：数数值型，返返回值=0：

24、调调用正常常，0：调调用不正正常。参 数：无。!CopyySavveDaat()函数说明：此函数数在嵌入入版中无无效，考考虑兼容容性问题题，故保保留。!DelSSaveeDatt(DaatNaame,Numm)函数意义：删除组组对象DDatNNamee对应的的存盘数数据中最最早Nuum小时时内的存存盘数据据，如果果 Nuum 00,就删删除以当当前时间间为基点点Numm个小时时之前的的内容,删除时时是按文文件删除除的，如如果数据据不足一一个存盘盘文件，是是不会被被删除的的。返回值：数数值型，返返回值=0：调调用正常常，0：调调用不正正常。参 数：DattNamme，组组对象名名。 NNum ,

25、 参参数名。实 例：!DeelSaaveDDat(电机温温度，112) ，删除除组对象象“电机温温度”对应的的存盘数数据中以以当前时时间为基基点倒推推12个小小时之前前的数据据。但从从当前时时间至倒倒推的112个小小时之内内的内容容会被保保存。注 意：该函函数只对对组对象象操作有有效。!DelAAllSSaveeDatt()函数意义：删除组组对象DDataaNamme对应应的所有有存盘数数据。注注意，此此函数不不能用来来删除组组对象所所对应的的报警存存盘数据据。返回值：数数值型，返返回值=0：调调用正常常，0：调调用不正正常。参 数：DattNamme：组组对象名名；实 例：!DeelAlll

26、SaaveDDat（电电机温度度），删删除组对对象“电机温温度”对应的的所有存存盘数据据注 意：该函函数只对对组对象象操作有有效。!EnabbleDDataaSavve(nnamee,n)函数意义：打开/关闭数数据对象象的定时时存盘功功能。返回值：数数值型，返返回值=0：调调用正常常，0：调调用不正正常。参 数：namme，数数据对象象名；n，数值型型，1表示打打开定时时存盘，0表示关闭定时存盘。实 例：!EnnablleDaataSSavee(温度度,1)，打开温温度的定定时存盘盘。!ExpoortHHisDDataaToCCSV(文件名名,组对象象名,字段名名,开始时时间,结束时时间,最大

27、记记录数,导出模模式,导出参参数,进度指指示数据据对象名名,取消控控制数据据对象名名)函数意义：1.导出出指定组组对象存存盘数据据，导出出的条件件包括：开始时时间-结束时时间，最最大导出出总条数数;2.导出出字段列列表，组组对象为为MCGGS_AALARRM则表表示导出出报警历历史数据据；3.可指指定导出出文件名名和路径径，主要要是U盘导出出，可以以追加方方式也可可覆盖方方式导出出；4.可显显示导出出过程进进度情况况；5.可取取消和中中止长时时间的导导出过程程；6.导出出格式为为csvv文件，导导出的第第一行为为字段名名字。返回值：开开关型。返回1 指指定组对对象错误误，可能能组对象象没有保保

28、存历史史数据或或者没有有该组对对象返回2 指指定的时时间格式式错误返回3 指指定的无无效的数数据对象象名返回4 无无效的导导出模式式返回5 同同时只能能支持一一个cssv导出出参 数：文件名：字字符型，指指定导出出的文件件绝对路路径名，指指定的第第一级目目录不能能创建，其其子目录录如果不不存在则则可以创创建。这这样避免免U盘不存存在时创创建U盘目录录。注意意：第一一级目录录不能自自动创建建用户必必须保证证其存在在；组对象名：导出的的组对象象名字。字段名：字字符型，用用逗号分分隔的要要导出的的字段名名，不需需要指定定时间字字段，默默认第一一二个字字段就为为记录时时间字段段。如果果为空字字符串则则

29、导出所所有字段段。开始时间，结结束时间间：用表表示的时时间字符符串 “YYYYYY-MMM-DDD HHH：MM：SS”；最大记录数数：希望望导出的的最大记记录数，超超过该记记录数就就返回，停停止导出出；导出模式：“1”表表示覆盖盖现有文文件，“22”表示示追加到到文件最最后；导出参数：暂时为为空，保保留以后后使用；进度指示数数据对象象名：开开关型数数据对象象，导出出过程中中该对象象值反映映出当前前已导出出记录条条数，如如果导出出过程中中其他异异常结束束则通过过该对象象返回同同函数返返回错误误码； 进度指指示错误误码：返回-11文件不不能打开开返回-22没有可可导出的的数据返回-44文件操操作

30、出现现错误控制数据对对象名：指定一一个开关关型数据据对象,该对象象控制导导出执行行，启动动导出时时会自动动设置该该变量为为0，用户户在导出出过程中中想取消消导出则则可以设设置该值值为00的任何何值，导导出函数数运行结结束后会会自动设设置对象象值为11； 进进度指示示错误码码：返回0导导出成功功返回-11导导出路径径不存在在返回1指指定组对对象错误误，可能能组对象象没有保保存历史史数据或或者没有有该组对对象返回2指指定的时时间格式式错误返回3指指定的无无效的数数据对象象名返回4无无效的导导出模式式返回5同同时只能能支持一一个cssv导出出实 例: reet= !ExxporrtHiisDaata

31、TToCSSV(ussb hhardddisskyyangg.cssv,grroupp,datta1,datta4,220077/1/1 00:0:0,20009/1/11 0:0:00,2200000,11,进度度,控制)!GetAAlmVValuue(DDatNNamee,Vaaluee,Fllag)函数意义：读取数数据对象象DattNamme报警警限值，只只有在数数据对象象DattNamme的“允许进进行报警警处理”属性选选项被选选中后，本本函数的的操作才才有意义义。对组组对象、字字符型数数据对象象、事件件型数据据对象本本函数无无效。对对数值型型数据对对象，用用Flaag来标标识读取取何

32、种报报警限值值。返回值：数数值型，返返回值=0：调调用正常常，0：调调用不正正常。参 数：DattNamme：数数据对象象名。Valuee：DattaNaame的的当前的的报警限限值，数数值型。Flag：数值型型，标志志要读取取何种限限值，具具体意义义如下：=1下下限限报警值值；=2 下限限报警值值；=3 上限限报警值值；=4 上上上限报警警值；=5 下偏偏差报警警限值；=6 上偏偏差报警警限值；=7 偏差差报警基基准值；实 例:!GGetAAlmVValuue(电电机温度度,Vaaluee,3)，读取取数据对对象“电机温温度”的报警警上限值值，放入入数值型型数据对对象Vaaluee中。!Ge

33、tEEvenntDTT()函数说明：此函数数在嵌入入版中无无效，考考虑兼容容性问题题，故保保留。!GetEEvenntP()函数说明：此函数数在嵌入入版中无无效，考考虑兼容容性问题题，故保保留。!GetEEvenntT()函数说明：此函数数在嵌入入版中无无效，考考虑兼容容性问题题，故保保留。!MoveeSavveDaat()函数说明：此函数数在嵌入入版中无无效，考考虑兼容容性问题题，故保保留。!SaveeDatta(DDatNNamee)函数意义：把数据据对象DDataaNamme对应应的当前前值存入入存盘数数据库中中。本函函数的操操作使对对应的数数据对象象的值存存盘一次次。此数数据对象象必须

34、具具有存盘盘属性，且且存盘时时间需设设为0秒。否否则会操操作失败败。返回值：数数值型，=0为操作成功，0为操作失败。参 数：DattNamme，数数据对象象名。实 例：!SaaveDDataa(电机机1)，把把组对象象“电机1”的所所有成员员对应的的当前值值存盘一一次。!SaveeDattaInnit()函数意义：本操作作把设置置有“退出时时自动保保存数据据对象的的当前值值作为初初始值”属性的的数据对对象的当当前值存存入组态态结果数数据中作作为初始始值，防防止突然然断电而而无法保保存，以以便MCCGS嵌嵌入版下下次启动动时这些些数据对对象能自自动恢复复其值。返回值：数数值型，返返回值=0：调调

35、用正常常，0：调调用不正正常。参 数：无。实 例：!SaaveDDataaIniit()。注 意：此函函数单独独使用不不起作用用，需要要和函数数!Fllushhdattainnitvvaluuetoodissk()一起使使用。!SaveeDattaOnnTimme(TTimee,TiimeMMS,DDataaNamme)函数意义：使用指指定时间间保存数数据。本本函数通通常用于于指定时时间来保保存数据据，实现现与通常常机制不不一样的的存盘方方法。返回值：数数值型，返返回值=0：调调用正常常，0：调调用不正正常。参 数：Timme，数数值型，使使用时间间函数转转换出的的时间量量。时间间精度到到秒。

36、TimeMMS，数数值型，指指定存盘盘时间的的毫秒数数。实 例：t =!TiimeSStr22I(20001年2月21日3时2分3秒)；!SaaveDDataaOnTTimee (tt,0,DattaGrroupp)，按照指指定时间间保存数数据对象象。!SaveeSinngleeDattaInnit(Namme)函数意义：本操作作把数据据对象的的当前值值设置为为初始值值（不管管该对象象是否设设置有“退出时时自动保保存数据据对象的的当前值值作为初初始值”属性），防防止突然然断电而而无法保保存，以以便MCCGS嵌嵌入版下下次启动动时这些些数据对对象能自自动恢复复其值。返回值：数数值型，返返回值=0

37、：调调用正常常，0：调调用不正正常。参 数：Namme，数数据对象象名。实 例：!SaaveSSinggleDDataaIniit(温温度)，把温温度的当当前值设设置成初初始值。!SetAAlmVValuue(DDatNNamee,Vaaluee,Fllag)函数意义：设置数数据对象象DattNamme对应应的报警警限值，只只有在数数据对象象DattNamme“允允许进行行报警处处理”的属性性被选中中后，本本函数的的操作才才有意义义。对组组对象、字字符型数数据对象象、事件件型数据据对象本本函数无无效。对对数值型型数据对对象，用用Flaag来标标识改变变何种报报警限值值。返回值：数数值型，返返回

38、值=0：调调用正常常，0：调调用不正正常。参 数：DattNamme：数数据对象象名。Valuee：新的的报警值值，数值值型。Flag：数值型型，标志志要操作作何种限限值，具具体意义义如下：=1下下限限报警值值；=2下限报报警值；=3上限报报警值；=4上上限限报警值值；=5下偏差差报警限限值；=6上偏差差报警限限值；=7偏差报报警基准准值；实 例：!SeetAllmVaaluee(电机机温度,2000,3)，把数数据对象象“电机温温度”的报警警上限值值设为2200!TrannsTooUSBB(组对对象名,起始时时间,结束时时间,导出状状态,进度指指示,转出模模式,保留参参数)函数意义：将XXX

39、X组对象象的存盘盘数据导导出到USBB HAARDDDISKK目录录下，保保存为“XXXX.csvv”文件件，模拟拟环境则则是保存存到与可可执行文文件相同同路径下下。返回值：开开关型。0：参数数没有错错误。1：第一一个参数数错误。（请请检查是是否组对对象名称称，或“MMCGSS_ALLARMM”）2: 时时间参数数格式错错误。3：状态态变量的的类型错错误。（两两个变量量都必须须是开关关量）5：同时时只能支支持一个个csvv导出。参 数： 组对象象名：字字符型，要要导出的的组对象象名称（或或“MCCGS_ALAARM”）。起始时间：字符型型，要导导出的历历史数据据的开始始时间，格格式：YYYYY

40、Y-MMM-DDD HHH:MMM:SSS。结束时间：字符型型，要导导出的历历史数据据的结束束时间，格格式：YYYYYY-MMM-DDD HHH:MMM:SSS。导出状态：开关型型，进度度指示数数据对象象名（开开关量），输输出导出出状态。 正正常导出出存盘后后输出当当前已经经导出的的记录条条数。 当当创建导导出文件件“XXXX.ccsv”失败时输出1。（请检查下位机是否正常插入了U盘） 当前没没有记录录可导出出时输出出2。（请请检查对对应的组组对象是是否有存存盘信息息，或者者开始时时间结束束时间是是否设置置正确） 导导出过程程中出现现未知数数据类型型时输出出3。（不不应该出出现） 导导出过程程

41、中出现现文件操操作异常常时输出出4。（请请检查UU盘容量量是否足足够）进度指示：开关量量，指定定一个数数字型或或开关型型对象,该对象象控制导导出执行行，启动动导出时时会自动动设置该该变量为为0，用户户在导出出过程中中想取消消导出可可设置该该变量为为0的任任何值，导导出函数数运行结结束后会会自动设设置对象象值为11。 注注：6.55（01.00110）之之前的版版本，此此参数为为原导出出状态变变量2，显示示的是导导出数据据总条数数。转出模式：开关型型，保留留，设置置为0。保留参数：字符型型，保留留, 设置置为空字字符串。实 例例：!TrannsTooUSBB(MCCGS_ALAARM , 220

42、088-122-1 00:00:00 , 220088-122-311 000:000:000 , Swiitchh01 , SSwittch002 , 0 , )。注意事项：该函数最多多只能导导出3000000条记录录。当满满足导出出时间条条件的记记录数大大于3000000时，只只导出前前300000条条记录。!CopyyDatteFiileTToDiisk(patthNaame,dattaTyype,coppySttatee)函数意义: 拷贝贝当前运运行工程程的数据据到指定定的目录录patthNaame中中。返回值:1：在拷贝贝的过程程中,数据对对象coopySStatte,由由0转变为为

43、非0.表示用用户不想想继续拷拷贝。0：表示拷拷贝成功功。-1：当前前工程中中,当前运运行工程程中没有有组对象象要存盘盘。-2：创建建目录ppathhNamme失败败。 -3：创佳佳索引文文件MCCGS_DATTA.iini失失败或者者对此文文件进行行写操作作失败。-4：参数数dattaTyype的的值,不正确确,目前只只支持值值为0。-5：磁盘盘空间不不足。-6：参数数coppySttatee不是数数据对象象类型。-7：参数数coppySttatee是数据据对象类类型,但不是是开关型型数据对对象。-8：参数数coppySttatee在一开开始调用用此脚本本时,就为非非0。参数说明:pathNN

44、amee：字符符串型.要拷贝贝数据到到此的路路径名.例如:在模拟拟环境可可以写d:tesst,在运行行环境可可写hhardddisskttestt。dataTTypee：开关关型.拷贝数数据的类类型,00表示历历史数据据,1表示示报警数数据.目前只只支持拷拷贝历史史数据,报警数数据还没没有处理理。copySStatte：数数据对象象型.是否拷拷贝的标标志.当为0表示可可以拷贝贝,为非0表示取取消当前前的拷贝贝。实 例：!CoopyDDateeFilleTooDissk(harrddiisktesst,0,ccopyyStaate) 把当当前工程程中历史史数据拷拷贝到目目录hhardddissk

45、ttestt中(如coppySttatee为0表示拷拷贝,为非表表示取消消)。说 明：一般般此脚本本要配合合组态环环境中的的一个小小程序DDataaTraans.exee来一起起操作.把拷贝贝的数据据目录,通过U盘或其其他方式式,导到上上位机(PC),通过过用程序序DattaTrranss.exxe来进进行数据据的转换换。用户登录操操作函数数!ChanngePPasssworrd()函数意义：弹出密密码修改改窗口，供供当前登登录的用用户修改改密码。返 回 值值：数值值型。返返回值=0：调调用成功功；0：调调用失败败。参 数：无无。实 例：!ChaangeePassswoord()。!Checc

46、kUsserGGrouup(sstrUUserrGrooup)函数意义：检查当当前登录录的用户户是否属属于sttrUsserGGrouup用户户组的成成员。返 回 值值：数值值型。返返回值=0：调调用成功功；0：调调用失败败。参 数：strrUseerGrroupp，字符符型，用用户组的的名称。实 例：!ChheckkUseerGrroupp(管管理员组组)。!Edittuseers()函数意义：弹出用用户管理理窗口，供供管理员员组的操操作者配配置用户户。返 回 值值：数值值型。返返回值=0：调调用成功功；0：调调用失败败。参 数：无无。实 例：!Ediitusserss()。!Enabble

47、EExittLoggon(n)函数意义：打开/关闭退退出时的的权限检检查。返 回 值值：数值值型。返返回值=1：操操作成功功；返回回值=00：操作作失败。参 数：nn，数值值型，为为1时表表示在退退出时进进行权限限检查，当当权限不不足时，会会进行提提示。为为0则退退出时不不进行权权限检查查。实 例：!EnnablleExxitLLogoon(11)， 在退出出时进行行权限检检查。!EnabbleEExittProomptt(n)函数意义：打开/关闭退退出时的的提示信信息。返 回 值值：数值值型。返返回值=0：调调用成功功；0：调调用失败败。参 数：nn，数值值型，为为1时表表示在退退出时弹弹出

48、提示示信息对对话框。为为0则退退出时不不出现信信息对话话框。实 例：!EnnablleExxitPPrommpt(1)， 在退出出时弹出出提示信信息对话话框。!GetCCurrrenttGrooup()函数意义：读取当当前登录录用户的的所在用用户组名名。返 回 值值：字符符型，当当前登录录用户组组名，如如没有登登录返回回空。参 数：无无。实 例：!GeetCuurreentGGrouup()。!GetCCurrrenttUseer()函数意义：读取当当前登录录用户的的用户名名。返 回 值值：字符符型，当当前登录录用户的的用户名名，如没没有登录录返回空空。参 数：无无。实 例：!GeetCuur

49、reentUUserr()。!LogOOff()函数意义：注销当当前用户户。返 回 值值：数值值型。返返回值=0：调调用成功功；0：调调用失败败。参 数：无无。实 例：!LoogOfff()。!LogOOn()函数意义：弹出登登录对话话框。返 回 值值：数值值型。返返回值=0：调调用成功功；0：调调用失败败。参 数：无无。实 例：!LoogOnn()。字符串操作作函数!Asciii2II(s)函数意义：返回字字符串ss的首字字母的AAsciii值。返 回 值值：开关关型。参 数：ss， 字字符型。实 例：!Assciii2I(Affd)=655。!Bin22I(ss)函数意义：把二进进制字符符

50、串转换换为数值值。返 回 值值：开关关型。参 数：ss， 字字符型。实 例：!Biin2II(1101)=55。!Formmat(n,sstr)函数意义：格式化化数值型型数据对对象。返 回 值值：字符符型。参 数：nn，数值值型，要要格式化化的数值值；str，字字符型，格格式化数数值的格格式。表表示为00.000样式。小小数点后后的0的的个数表表示需要要格式化化出的小小数位数数。小数数点前的的0为一一个时，表表示小数数点前根根据 实际数数值显示示。当小小数点前前没有00时，表表示为.xx式式样，当当小数点点前的00不止一一个时，使使用0来来填充不不够的位位数。实 例：!Foormaat(11.

51、2336,0.000) = 1.24；!Foormaat(11.2336,.000)= .24；!Formmat(1.2236,000.000) = 01.24。!Hex22I(ss)函数意义：把166进制字字符串转转换为数数值。返 回 值值：开关关型。参 数：ss， 字字符型。实 例：!Heex2II(111) =117。!I2Assciii(s)函数意义：返回指指定Assciii值的字字符。返 回 值值：字符符型。参 数：ss， 开开关型。实 例：!I22Asccii(65) =“AA”。!I2Biin(ss)函数意义：把数值值转换为为二进制制字符串串。返 回 值值：字符符型。参 数：ss

52、，开关关型。实 例：!I22Binn(5) =“1101”!I2Heex(ss)函数意义：把数值值转换为为16进进制字符符串。返 回 值值：字符符型。参 数：ss，开关关型。实 例：!I22Hexx(177) =“111”。!I2Occt(ss)函数意义：把数值值转换为为8进制制字符串串。返 回 值值：字符符型。参 数：ss，开关关型。实 例：!I22Octt(9) =“111”。!InSttr(nn，strr1，strr2)函数意义：查找一一字符串串在另一一字符串串中最先先出现的的位置。返 回 值值：数值值型。参 数：n，数值值型，开开始搜索索的位置置；str1，字字符串，被被搜索的的字符串

53、串；str2，字字符串，要要搜索的的字符串串。实 例：!InnStrr(3,sddlkffjwee,we) = 7。!Lcasse(sstr)函数意义：把字符符型数据据对象sstr的的所有字字符转换换成小写写。返 回 值值：字符符型。参 数：strr， 字字符型。实 例：!LCCasee(ssedEERT)= seederrt。!Leftt(sttr,nn)函数意义：字符型型数据对对象sttr左边边起，取取n个字符符。返 回 值值：字符符型。参 数：strr：字符符型，源源字符串串；n，数值值型，取取字符个个数。实 例：!Leeft(ABBCDEEFG,2) =ABB!Len(strr)函数意

54、义：求字符符型数据据对象sstr的的字符串串长度（字字符个数数）。返 回 值值：数值值型。参 数：strr， 字字符型。实 例：!Leen(ABCCDEFFG)= 77。!Ltriim(sstr)函数意义：把字符符型数据据对象sstr中中最左边边的空格格剔除。返 回 值值：字符符型。参 数：strr， 字字符型。实 例：!LTTrimm( ddsfkk ) = dsffk !lVall(sttr)函数意义：将字符符串转化化为长数数值型数数值返 回 值值：开关关型，转转换出的的数值。参 数：strr，字符符型。待待转换的的字符串串。实 例：!lVVal(12234556788)=12334566

55、78。!Mid(strr,n,k)函数意义：从字符符型数据据对象sstr左左边第nn个字符符起，取取k个字符符。数字字字符时时，从零零开始算算起。返 回 值值：字符符型。参 数：strr， 字字符型，源源字符串串；n， 数数值型，起起始位置置；k， 数数值型，取取字符数数。实 例：!Miid(ABCCDEFFG，3，2) = DE。!Oct22I(ss)函数意义：把8进进制字符符串转换换为数值值。返 回 值值：开关关型。参 数：s， 字字符型。实 例：!Occt2II(111) =99。!Righht(sstr,n)函数意义：从字符符型数据据对象sstr右右边起，取取n个字符符。返 回 值值：

56、字符符型。参 数：strr，字符符型，源源字符串串；n，数值值型，取取字符个个数。实 例：!Riightt(AABCDDEFGG,22) =FFG。!Rtriim(sstr)函数意义：把字符符型数据据对象sstr中中最右边边的空格格剔除。返 回 值值：字符符型。参 数：strr， 字字符型。实 例：!Rttrimm( ddsfkk ) = ddsfkk。!Str(x)函数意义：将数值值型数据据对象xx的值转转换成字字符串。返 回 值值：字符符型。参 数：x， 数数值型。实 例：!Sttr(00.7112) =00.7112。!StrCCompp(sttr1,strr2)函数意义：比较字字符型数

57、数据对象象strr1和strr2是否否相等，返返回值为为0时相相等，否否则不相相等。不不区分大大小写字字母。返 回 值值：数值值型。参 数：strr1， 字符型型；str2， 字符型型。实 例：!SttrCoomp(ABBC,abbc) = 0。!StrFFormmat(ForrmattStrr,任意意个数变变量)函数意义：格式化化字符串串，可以以格式化化任意多多个数值值。使用用方法为为!SttrFoormaat(%d,233)，或或!SttrFoormaat(%g-%g-%g,2.3,22.1,2.22)等，类类似C语语言中的的 Priintff的语法法。返 回 值值：字符符型。参 数：Fo

58、rrmattStrr， 字字符型，格格式化字字符串。后后面的参参数可以以任意多多个。实 例：!SttrFoormaat(%g%gg,112,112.334)= 11212.34。!Trimm(sttr)函数意义：把字符符型数据据对象sstr中中左右两两端的空空格剔除除。返 回 值值：字符符型。参 数：strr， 字字符型。实 例：!Trrim( dsffk ) =dsffk。!Ucasse(sstr)函数意义：把字符符型数据据对象sstr的的所有字字符转换换成大写写。返 回 值值：字符符型。参 数：strr， 字字符型。实 例：!UCCasee(ssedEERT) =SEEDERRT。!Val

59、(strr)函数意义：把字符符型数据据对象sstr的的值转换换成数值值。返 回 值值：数值值型。参 数：strr， 字字符型。实 例：!Vaal(0.7712) = 0.7122。定时器操作作函数可用的系统统定时器器范围为为1到1127，即即系统内内嵌1227个系系统定时时器。用用户可以以随意使使用其中中的任意意一个。定时器返回回时间值值为数值值型，单单位为秒秒,分，时时，但是是小数位位最多可可以表示示到毫秒秒。因为为采用浮浮点数表表示，随随着数值值增大会会略有误误差。!TimeerCllearrOuttputt(定时时器号)函数意义: 清除除定时器器的数据据输出连连接。返 回 值值：数值值型

60、。返返回值=0：调调用成功功；0：调调用失败败。参 数：定定时器号号。实 例：!TiimerrCleearOOutpput(1)，清清除1号号定时器器的数据据输出连连接。!TimeerRuun(定定时器号号)函数意义：启动定定时器开开始工作作。返 回 值值：数值值型。返返回值=0：调调用成功功；0：调调用失败败。参 数：定定时器号号。实 例：!TiimerrRunn(1)，启动动1号定定时器工工作。!TimeerSttop(定时器器号)函数意义：停止定定时器工工作。返 回 值值：数值值型。返返回值=0：调调用成功功；0：调调用失败败。参 数：定定时器号号。实 例：!TiimerrStoop(1