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)，关闭报警策略，使报警策略无效。!GetDeviceName(Index)函数意义：按设备顺序取到设备的名字。返回值：字符型。调用成功返回设备名，调用失败时返回空字符串。参数：Index，数值型。实例：!GetDeviceName(0)，取0号设备构件的名称。!GetDeviceState(DevName)函数意义：按设备名查询设备的状态。返回值：数值型。=-1调用不正常。=1设备处于正常的工作状态。=2设备正在工作，但设备不正常。=3设备处于停止工作状态，且设备正常。=4设备处于停止状态，且设备有错。参数：DevName，设备名，字符型。实例：!GetDeviceState(OmronPLC)，读取设备构件〝OmronPLC〞的当前工作状态。注意：设备名称是在设备构件差不多属性页中设置的。 !GetLastMouseActionTime()函数意义：猎取最后一次鼠标的动作发生的时刻。返回值：开关型。返回为time_t类型的时刻值，能够在时刻操作脚本函数中使用。参数：无。实例：在画面，系统对话框上的鼠标事件中添加!GetLastMouseActionTime()，猎取鼠标最后动作时刻。 !GetStgyName(Index)函数意义：按运行策略的顺序获得各策略块的名字。返回值：字符型。参数：Index，数值型。实例：!GetStgyName(0)，取0号运行策略的名称。!GetWindowName(Index)函数意义：按用户窗口的顺序获得用户窗口的名字。返回值：字符型。参数：Index，数值型。实例：!GetWindowName(0)，读取0号用户窗口的名称。!GetWindowState(WndName)函数意义：按照名字取得用户窗口的状态。返回值：数值型。返回0：用户窗口处于关闭状态。返回1：用户窗口处于打开状态。返回2：用户窗口处于隐藏状态。参数：WndName，用户窗口名称，字符型。实例：!GetWindowState(工况图)，获得用户窗口〝工况图〞的状态。!OpenSubWnd〔参数1,参数2，参数3，参数4，参数5，参数6〕函数意义：显示子窗口。返回值：字符型，如成功就返回子窗口n，n表示打开的第n个子窗口。参数值：参数1：要打开的子窗口名。参数2：整型，打开子窗口相关于本窗口的X坐标。参数3：整型，打开子窗口相关于本窗口的Y坐标。参数4：整型，打开子窗口的宽度。参数5：整型，打开子窗口的高度。参数6：整型，打开子窗口的类型。0位：是否模式打开，使用此功能，必须在此窗口中使用CloseSubWnd来关闭本子窗口，子窗口外别的构件对鼠标操作不响应1位：是否菜单模式，使用此功能，一旦在子窗口之外按下按钮，那么子窗口关闭。2位：是否显示水平滚动条，使用此功能，能够显示水平滚动条3位：是否垂直显示滚动条，使用此功能，能够显示垂直滚动条4位：是否显示边框，选择此功能，在子窗口周围显示细黑线边框5位：是否自动跟踪显示子窗口，选择此功能，在当前鼠标位置上显示子窗口。此功能用于鼠标打开的子窗口，选用此功能那么忽略iLeft,iTop的值，假如现在鼠标位于窗口之外，那么在窗口对中显示子窗口6位：是否自动调整子窗口的宽度和高度为缺省值，使用此功能那么忽略iWidth和iHeight的值。子窗口的关闭方法：使用关闭窗口直截了当关闭，那么把整个系统中使用到的此子窗口完全关闭使用指定窗口的CloseSubWnd关闭，能够使用OpenSubWnd返回的控件名，也能够直截了当指定子窗口关闭，现在只能关闭此窗口下的子窗口。!SetActiveX()函数说明：此函数在嵌入版中无效，考虑兼容性问，故保留。!CallBackSvr()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!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〞开始工作。 !SetMousePace(开关型)函数意义：设置鼠标灵敏度。参数：开关型参数为每次按键消息需要设置的鼠标移动间隔，一样情形下请输入正整数，假如输入0值表示禁止该功能实例：!SetMousePace(1);默认情形下该功能为关闭状态，鼠标灵敏度为0，假如想启用该功能在启动策略中调用!SetMousePace脚本函数指定步长值。!SetNumPanelSize(Type,Size)函数意义：依照需要和显示屏的大小调整软键盘的大小。返回值：开关型。返回值=0：修改成功。新设置将在下一次打开输入键盘时生效。返回值=1：修改失败，参数错误。〔可能是没有匹配的type，或者size参数超出范畴〕。参数：Type，键盘类型，数值型；1：代表修改数值输入键盘。2：代表修改字符输入键盘；。3：代表修改用户登录对话框。Size，键盘大小，数值型；数值范畴：200像素~1024像素；实例：!SetNumPanelSize(1,500)，将数值输入键盘改为500*500大小，该正方形相关于屏幕居中。所有修改将在下一次打开输入框时生效，运行环境退出后，将自动保留上次输入框的大小。本卷须知：键盘放大缩小功能在重新下载工程时没有删除配置文件，换工程后设置仍旧有效，除非重新进行了设置。假如要去掉原先的设置那么需要手工删除panelSize.ini文件，该文件位于\harddisk\mcgsbin名目下。 !SetStgy(StgyName)函数意义：执行StgyName指定的运行策略。返回值：数值型。返回值=0：调用正常，<>0：调用不正常。参数：StgyName，策略名，字符型。实例：!SetStgy(阀门关闭)，执行一次运行策略〝阀门关闭〞。!SetWindow(WndName,Op)函数意义：按照名字操作用户窗口，如打开、关闭、打印。返回值：数值型。返回值：=0：调用正常。<>0：调用不正常。参数：WndName，用户窗口名，字符型。Op:操作用户窗口的方法，数值型。Op=1：打开窗口并使其可见。Op=2：打开窗口并使其不可见。Op=3：关闭窗口。Op=4：打印窗口。Op=5：刷新窗口。实例：!SetWindow(工况图,1)，打开用户窗口〝工况图〞，并使其可见。!SysWindow()函数意义：执行该函数后，打开用户窗口治理窗口，在治理窗口中能够选择打开或关闭指定的用户窗口。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：无。实例：!SysWindow()。!SetStyMode(StgyName)函数意义：通过脚本函数〔位于系统函数-运行环境类〕实现函数调用方式的策略调用。返回值：开关型，返回值恒为0。参数：StgyName，策略名，字符型。实例：!SetStgyMode(阀门关闭)，执行一次运行策略〝阀门关闭〞，〝阀门关闭〞策略执行完毕后，才返回调用者，调用者连续执行以下程序。 !GetCurrentLanguageIndex()函数意义：用于猎取当前使用的语言的索引值。返回值：开关型。返回值为语言项索引值。索引值按照组态下拉框依次排序0，1，2…参数：无。实例：N=!GetCurrentLanguageIndex()，其中N为开关型变量。!SetCurrentLanguageIndex(开关型)函数意义：通过索引项设定当前语言环境返回值：开关型。返回值为0表示执行成功，否那么表示失败。参数：开关型。语言索引值。假如索引参数值超出当前选择语言范畴，那么函数不生效。实例：!SetCurrentLanguageIndex(1)，表示设置当前语言为英文〔选择语言为CH，EN〕。!GetLocalLanguageStr(开关型)函数意义：获得指定自定义ID对应的当前语言的内容。返回值：字符型。参数：开关型。自定义ID索引值。假如无当前ID对应自定义文本，那么返回空值。实例：!GetLocalLanguageStr〔2〕，前提是有ID为2的自定义文本内容，假如当前语言为英文，那么返回ID为2的自定义文本记录的英文内容。!GetLanguageNameByIndex(开关型)函数意义：依照语言索引值返回语言名称，返回值为字符型。返回值：字符型，当前语言的名称。参数：开关型。语言的索引值。假如当前索引值无对应语言，那么返回空值。实例：!GetLanguageNameByIndex(1)，假如当前语言为中文、英文，那么返回值为English。数据对象操作函数  !AnswerAlm(DatName) 函数意义：应答数据对象DatName所产生的报警。如对应的数据对象没有报警产生或差不多应答，那么本函数无效。返回值：数值型，=0为操作成功，<>0为操作失败。参   数：DatName，数据对象名。实   例：!AnswerAlm(电机温度)，应答数据对象〝电机温度〞所产生的报警。 !ChangeDataSave(Datname,n) 函数意义：改变数据对象Datname存盘的周期。返回值：数值型，=0为操作成功，<>0为操作失败。参   数：Datname，数据对象名；n，数值型，以秒表示的存盘间隔时刻。实   例：!ChangeDataSave(温度,5)，温度的存盘间隔时刻为5秒。 !ChangeSaveData(DatName,Num1,Num2) 该函数在通用版中能够使用，在嵌入版中不能使用！函数意义：改变数据对象DatName所对应存盘数据的存盘间隔，把Num1小时往常的存盘数据〔以当前时刻为0点〕的存盘间隔改为Num2秒。本操作只对组对象有效，对单个的数据对象无效。当DataName=空字符，或Num1=0或Num2=0时，本操作无效。返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参   数：DatName：数据对象名。Num1：数值型时刻量，单位：小时。本函数用Num1<0的一些数值来表示一些专门意义的操作：=-1改变当天对应数据对象所有存盘数据的存盘间隔；=-2改变昨天对应数据对象所有存盘数据的存盘间隔；=-3改变本星期对应数据对象所有存盘数据的存盘间隔；=-4改变上星期对应数据对象所有存盘数据的存盘间隔；=-5改变本月对应数据对象所有存盘数据的存盘间隔；=-6改变上个月对应数据对象所有存盘数据的存盘间隔；Num2：数值型时刻量，新的存盘间隔，单位：秒。实   例：!ChangeSaveData(电机1,-2,5)，把组对象〝电机1〞对应的存盘数据中昨天的存盘数据的存盘间隔改为5秒钟。 !FlushDataInitValueToDisk() 函数意义：把所有数据对象的初始值写入磁盘。返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参   数：无。 !CopySaveDat() 函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。 !DelSaveDat(DatName,Num) 函数意义：删除组对象DatName对应的存盘数据中最早Num小时内的存盘数据，假如Num<=0,那么确实是删除该组对象全部的存盘数据。假如Num>0,就删除以当前时刻为基点Num个小时之前的内容,删除时是按文件删除的，假如数据不足一个存盘文件，是可不能被删除的。返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参   数：DatName，组对象名。         Num,参数名。实   例：!DelSaveDat(电机温度，12)，删除组对象〝电机温度〞对应的存盘数据中以当前时刻为基点倒推12个小时之前的数据。但从当前时刻至倒推的12个小时之内的内容会被储存。注   意：该函数只对组对象操作有效。 !DelAllSaveDat() 函数意义：删除组对象DataName对应的所有存盘数据。注意，此函数不能用来删除组对象所对应的报警存盘数据。返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参   数：DatName：组对象名；实   例：!DelAllSaveDat〔电机温度〕，删除组对象〝电机温度〞对应的所有存盘数据注   意：该函数只对组对象操作有效。  !EnableDataSave(name,n) 函数意义：打开/关闭数据对象的定时存盘功能。返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参   数：name，数据对象名；n，数值型，1表示打开定时存盘，0表示关闭定时存盘。实   例：!EnableDataSave(温度,1)，打开温度的定时存盘。 !ExportHisDataToCSV(文件名,组对象名,字段名,开始时刻,终止时刻,最大记录数,导出模式,导出参数,进度指示数据对象名,取消操纵数据对象名) 函数意义： 1.导出指定组对象存盘数据，导出的条件包括：开始时刻-终止时刻，最大导出总条数; 2.导出字段列表，组对象为MCGS_ALARM那么表示导出报警历史数据； 3.可指定导出文件名和路径，要紧是U盘导出，能够追加方式也可覆盖方式导出； 4.可显示导出过程进度情形； 5.可取消和中止长时刻的导出过程； 6.导出格式为csv文件，导出的第一行为字段名字。返回值：开关型。返回1   指定组对象错误，可能组对象没有储存历史数据或者没有该组对象返回2   指定的时刻格式错误返回3   指定的无效的数据对象名返回4   无效的导出模式返回5   同时只能支持一个csv导出参   数：文件名：字符型，指定导出的文件绝对路径名，指定的第一级名目不能创建，其子名目假如不存在那么能够创建。如此幸免U盘不存在时创建U盘名目。注意：第一级名目不能自动创建用户必须保证其存在；组对象名：导出的组对象名字。字段名：字符型，用逗号分隔的要导出的字段名，不需要指定时刻字段，默认第一二个字段就为记录时刻字段。假如为空字符串那么导出所有字段。开始时刻，终止时刻：用表示的时刻字符串〝YYYY-MM-DDHH：MM：SS〞；最大记录数：期望导出的最大记录数，超过该记录数就返回，停止导出；导出模式：〝1〞表示覆盖现有文件，〝2〞表示追加到文件最后；导出参数：临时为空，保留以后使用；进度指示数据对象名：开关型数据对象，导出过程中该对象值反映出当前已导出记录条数，假如导出过程中其他专门终止那么通过该对象返回同函数返回错误码；                   进度指示错误码：              返回-1------文件不能打开              返回-2------没有可导出的数据              返回-4------文件操作显现错误操纵数据对象名：指定一个开关型数据对象,该对象操纵导出执行，启动导出时会自动设置该变量为0，用户在导出过程中想取消导出那么能够设置该值为<0的任何值，导出函数运行终止后会自动设置对象值为1；               进度指示错误码：              返回0------导出成功              返回-1-----导出路径不存在              返回1------指定组对象错误，可能组对象没有储存历史数据或者没有该组对象              返回2------指定的时刻格式错误              返回3------指定的无效的数据对象名              返回4------无效的导出模式              返回5------同时只能支持一个csv导出实   例:ret=!ExportHisDataToCSV("\usbharddisk\yang.csv","group","data1,data4","2007/1/10:0:0","2009/1/10:0:0",20000,1,"",进度,操纵) !GetAlmValue(DatName,Value,Flag) 函数意义：读取数据对象DatName报警限值，只有在数据对象DatName的〝承诺进行报警处理〞属性选项被选中后，本函数的操作才有意义。对组对象、字符型数据对象、事件型数据对象本函数无效。对数值型数据对象，用Flag来标识读取何种报警限值。返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参   数：DatName：数据对象名。Value：DataName的当前的报警限值，数值型。Flag：数值型，标志要读取何种限值，具体意义如下：=1下下限报警值；=2下限报警值；=3上限报警值；=4上上限报警值；=5下偏差报警限值；=6上偏差报警限值；=7偏差报警基准值；实   例:!GetAlmValue(电机温度,Value,3)，读取数据对象〝电机温度〞的报警上限值，放入数值型数据对象Value中。 !GetEventDT() 函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。 !GetEventP() 函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。 !GetEventT() 函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。 !MoveSaveDat() 函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。 !SaveData(DatName) 函数意义：把数据对象DataName对应的当前值存入存盘数据库中。本函数的操作使对应的数据对象的值存盘一次。此数据对象必须具有存盘属性，且存盘时刻需设为0秒。否那么会操作失败。返回值：数值型，=0为操作成功，<>0为操作失败。参   数：DatName，数据对象名。实   例：!SaveData(电机1)，把组对象〝电机1〞的所有成员对应的当前值存盘一次。 !SaveDataInit() 函数意义：本操作把设置有〝退出时自动储存数据对象的当前值作为初始值〞属性的数据对象的当前值存入组态结果数据中作为初始值，防止突然断电而无法储存，以便MCGS嵌入版下次启动时这些数据对象能自动复原其值。返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参   数：无。实   例：!SaveDataInit()。注   意：此函数单独使用不起作用，需要和函数!Flushdatainitvaluetodisk()一起使用。 !SaveDataOnTime(Time,TimeMS,DataName) 函数意义：使用指定时刻储存数据。本函数通常用于指定时刻来储存数据，实现与通常机制不一样的存盘方法。返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参   数：Time，数值型，使用时刻函数转换出的时刻量。时刻精度到秒。TimeMS，数值型，指定存盘时刻的毫秒数。实   例：t=!TimeStr2I("2001年2月21日3时2分3秒")；!SaveDataOnTime(t,0,DataGroup)，按照指定时刻储存数据对象。 !SaveSingleDataInit(Name) 函数意义：本操作把数据对象的当前值设置为初始值〔不管该对象是否设置有〝退出时自动储存数据对象的当前值作为初始值〞属性〕，防止突然断电而无法储存，以便MCGS嵌入版下次启动时这些数据对象能自动复原其值。返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参   数：Name，数据对象名。实   例：!SaveSingleDataInit(温度)，把温度的当前值设置成初始值。 !SetAlmValue(DatName,Value,Flag) 函数意义：设置数据对象DatName对应的报警限值，只有在数据对象DatName〝承诺进行报警处理〞的属性被选中后，本函数的操作才有意义。对组对象、字符型数据对象、事件型数据对象本函数无效。对数值型数据对象，用Flag来标识改变何种报警限值。返回值：数值型，返回值=0：调用正常，<>0：调用不正常。参   数：DatName：数据对象名。Value：新的报警值，数值型。Flag：数值型，标志要操作何种限值，具体意义如下：=1下下限报警值；=2下限报警值；=3上限报警值；=4上上限报警值；=5下偏差报警限值；=6上偏差报警限值；=7偏差报警基准值；实   例：!SetAlmValue(电机温度,200,3)，把数据对象〝电机温度〞的报警上限值设为200 !TransToUSB(组对象名,起始时刻,终止时刻,导出状态,进度指示,转出模式,保留参数)函数意义：将XXX组对象的存盘数据导出到"USBHARDDISK"名目下，储存为〝XXX.csv〞文件，模拟环境那么是储存到与可执行文件相同路径下。返回值：开关型。 0：参数没有错误。 1：第一个参数错误。〔请检查是否组对象名称，或〝MCGS_ALARM〞〕 2:时刻参数格式错误。 3：状态变量的类型错误。〔两个变量都必须是开关量〕 5：同时只能支持一个csv导出。参   数：组对象名：字符型，要导出的组对象名称〔或〝MCGS_ALARM〞〕。起始时刻：字符型，要导出的历史数据的开始时刻，格式：YYYY-MM-DDHH:MM:SS。终止时刻：字符型，要导出的历史数据的终止时刻，格式：YYYY-MM-DDHH:MM:SS。导出状态：开关型，进度指示数据对象名〔开关量〕，输出导出状态。   正常导出存盘后输出当前差不多导出的记录条数。   当创建导出文件〝XXX.csv〞失败时输出－1。〔请检查下位机是否正常插入了U盘〕   当前没有记录可导出时输出－2。〔请检查对应的组对象是否有存盘信息，或者开始时刻终止时刻是否设置正确〕   导出过程中显现未知数据类型时输出－3。〔不应该显现〕   导出过程中显现文件操作专门时输出－4。〔请检查U盘容量是否足够〕进度指示：开关量，指定一个数字型或开关型对象,该对象操纵导出执行，启动导出时会自动设置该变量为0，用户在导出过程中想取消导出可设置该变量为<0的任何值，导出函数运行终止后会自动设置对象值为1。         注：6.5〔01.0010〕之前的版本，此参数为原导出状态变量2，显示的是导出数据总条数。转出模式：开关型，保留，设置为0。保留参数：字符型，保留,设置为空字符串。实例：!TransToUSB(MCGS_ALARM,2008-12-100:00:00,2008-12-3100:00:00,Switch01,Switch02,0,"")。本卷须知：该函数最多只能导出30000条记录。当满足导出时刻条件的记录数大于30000时，只导出前30000条记录。  !CopyDateFileToDisk(pathName,dataType,copyState) 函数意义:拷贝当前运行工程的数据到指定的名目pathName中。返回值:1：在拷贝的过程中,数据对象copyState,由0转变为非0.表示用户不想连续拷贝。0：表示拷贝成功。-1：当前工程中,当前运行工程中没有组对象要存盘。-2：创建名目pathName失败。   -3：创佳索引文件MCGS_DATA.ini失败或者对此文件进行写操作失败。-4：参数dataType的值,不正确,目前只支持值为0。-5：磁盘空间不足。-6：参数copyState不是数据对象类型。-7：参数copyState是数据对象类型,但不是开关型数据对象。-8：参数copyState在一开始调用此脚本时,就为非0。参数说明:pathName：字符串型.要拷贝数据到此的路径名.例如:在模拟环境能够写"d:\test",在运行环境可写"harddisk\test"。dataType：开关型.拷贝数据的类型,0表示历史数据,1表示报警数据.目前只支持拷贝历史数据,报警数据还没有处理。copyState：数据对象型.是否拷贝的标志.当为0表示能够拷贝,为非0表示取消当前的拷贝。　实   例：!CopyDateFileToDisk("harddisk\test",0,copyState)把当前工程中历史数据拷贝到名目"harddisk\test"中(如copyState为0表示拷贝,为非表示取消)。说   明：一样此脚本要配合组态环境中的一个小程序DataTrans.exe来一起操作.把拷贝的数据名目,通过U盘或其他方式,导到上位机(PC),通过用程序DataTrans.exe来进行数据的转换。用户登录操作函数!ChangePassword()函数意义：弹出密码修改窗口，供当前登录的用户修改密码。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：无。实例：!ChangePassword()。!CheckUserGroup(strUserGroup)函数意义：检查当前登录的用户是否属于strUserGroup用户组的成员。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：strUserGroup，字符型，用户组的名称。实例：!CheckUserGroup("治理员组")。!Editusers()函数意义：弹出用户治理窗口，供治理员组的操作者配置用户。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：无。实例：!Editusers()。!EnableExitLogon(n)函数意义：打开/关闭退出时的权限检查。返回值：数值型。返回值=1：操作成功；返回值=0：操作失败。参数：n，数值型，为1时表示在退出时进行权限检查，当权限不足时，会进行提示。为0那么退出时不进行权限检查。实例：!EnableExitLogon(1)，在退出时进行权限检查。!EnableExitPrompt(n)函数意义：打开/关闭退出时的提示信息。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：n，数值型，为1时表示在退出时弹出提示信息对话框。为0那么退出时不显现信息对话框。实例：!EnableExitPrompt(1)，在退出时弹出提示信息对话框。!GetCurrentGroup()函数意义：读取当前登录用户的所在用户组名。返回值：字符型，当前登录用户组名，如没有登录返回空。参数：无。实例：!GetCurrentGroup()。!GetCurrentUser()函数意义：读取当前登录用户的用户名。返回值：字符型，当前登录用户的用户名，如没有登录返回空。参数：无。实例：!GetCurrentUser()。!LogOff()函数意义：注销当前用户。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：无。实例：!LogOff()。!LogOn()函数意义：弹出登录对话框。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：无。实例：!LogOn()。字符串操作函数!Ascii2I(s)函数意义：返回字符串s的首字母的Ascii值。返回值：开关型。参数：s，字符型。实例：!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")=".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(s)函数意义：把数值转换为8进制字符串。返回值：字符型。参数：s，开关型。实例：!I2Oct(9)=〝11〞。!InStr(n，str1，str2)函数意义：查找一字符串在另一字符串中最先显现的位置。返回值：数值型。参数：n，数值型，开始搜索的位置；str1，字符串，被搜索的字符串；str2，字符串，要搜索的字符串。实例：!InStr(3,"sdlkfjwe","we")=7。!Lcase(str)函数意义：把字符型数据对象str的所有字符转换成小写。返回值：字符型。参数：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)函数意义：将字符串转化为长数值型数值返回值：开关型，转换出的数值。参数：str，字符型。待转换的字符串。实例：!lVal("12345678")=12345678。!Mid(str,n,k)函数意义：从字符型数据对象str左边第n个字符起，取k个字符。数字字符时，从零开始算起。返回值：字符型。参数：str，字符型，源字符串；n，数值型，起始位置；k，数值型，取字符数。实例：!Mid("ABCDEFG"，3，2)="DE"。!Oct2I(s)函数意义：把8进制字符串转换为数值。返回值：开关型。参数：s，字符型。实例：!Oct2I("11")=9。!Right(str,n)函数意义：从字符型数据对象str右边起，取n个字符。返回值：字符型。参数：str，字符型，源字符串；n，数值型，取字符个数。实例：!Right("ABCDEFG",2)="FG"。!Rtrim(str)函数意义：把字符型数据对象str中最右边的空格剔除。返回值：字符型。参数：str，字符型。实例：!Rtrim("dsfk")="dsfk"。!Str(x)函数意义：将数值型数据对象x的值转换成字符串。返回值：字符型。参数：x，数值型。实例：!Str(0.712)="0.712"。!StrComp(str1,str2)函数意义：比较字符型数据对象str1和str2是否相等，返回值为0时相等，否那么不相等。不区分大小写字母。返回值：数值型。参数：str1，字符型；str2，字符型。实例：!StrComp("ABC","abc")=0。!StrFormat(FormatStr,任意个数变量)函数意义：格式化字符串，能够格式化任意多个数值。使用方法为!StrFormat("%d",23)，或!StrFormat("%g-%g-%g",2.3,2.1,2.2)等，类似C语言中的Printf的语法。返回值：字符型。参数：FormatStr，字符型，格式化字符串。后面的参数能够任意多个。实例：!StrFormat("%g--%g",12,12.34)="12--12.34"。!Trim(str)函数意义：把字符型数据对象str中左右两端的空格剔除。返回值：字符型。参数：str，字符型。实例：!Trim("dsfk")="dsfk"。!Ucase(str)函数意义：把字符型数据对象str的所有字符转换成大写。返回值：字符型。参数：str，字符型。实例：!UCase("sedERT")="SEDERT"。!Val(str)函数意义：把字符型数据对象str的值转换成数值。返回值：数值型。参数：str，字符型。实例：!Val("0.712")=0.712。定时器操作函数可用的系统定时器范畴为1到127，即系统内嵌127个系统定时器。用户能够随意使用其中的任意一个。定时器返回时刻值为数值型，单位为秒,分，时，然而小数位最多能够表示到毫秒。因为采纳浮点数表示，随着数值增大会略有误差。!TimerClearOutput(定时器号)函数意义:清除定时器的数据输出连接。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：定时器号。实例：!TimerClearOutput(1)，清除1号定时器的数据输出连接。!TimerRun(定时器号)函数意义：启动定时器开始工作。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：定时器号。实例：!TimerRun(1)，启动1号定时器工作。!TimerStop(定时器号)函数意义：停止定时器工作。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：定时器号。实例：!TimerStop(1)，停止1号定时器工作。!TimerSkip(定时器号,步长值)函数意义：在计时器当前时刻数上加/减指定值。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：定时器号；步长值。实例：!TimerSkip(1,3)，1号定时器当前值+3。!TimerReset(定时器号,数值)函数意义：设置定时器的当前值，由第二个参数设定，第二个参数能够是MCGS嵌入版变量。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：定时器号；数值。实例：!TimerReset(1,12)，设置1号定时器的值为12。!TimerValue(定时器号,0)函数意义：取定时器的当前值。返回值：将定时器的值以数值型的方式输出〔数值格式〕。参数：定时器号。实例：Data3=!TimerValue(1,0)，取定时器1的值给Data3。!TimerStr(定时器号,1)函数意义：以字符串的形式返回当前定时器的值。返回值：字符型变量，将定时器的值以字符型的方式输出〔时刻格式〕。参数：定时器号。实例：Time=!TimerStr(1,1)，取定时器的值以〝00：00：00”形式输出给Time。!TimerState(定时器号)函数意义：取定时器的工作状态。返回值：数值型变量，0-定时器停止，1-定时器运行。参数：定时器号。实例：data1=!TimerState(1)，取定时器1的工作状态给data1。!TimerSetLimit(定时器号,上限值,参数3)函数意义：设置定时器的最大值，即设置定时器的上限。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：定时器号(1-255)；上限值；第三个参数，1-表示运行到60后停止；0-表示运行到60后重新循环运行。实例：!TimerSetLimit(1,60,1)，设置1号定时器的上限为60，运行到60后停止。!TimerSetOutput(定时器号,变量)函数意义：设置定时器的值输出连接的变量。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：定时器号；变量，定时器的值输出连接的变量。实例：!TimerSetOutput(1,Data0)，将定时器数据连接到Data0。!TimerWaitFor(定时器号,数值)函数意义：等待定时器工作到〝数值〞指定的值后，脚本程序才向下执行。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：定时器号(1-255)；数值，等待定时器工作到指定的值。实例：!TimerWaitFor(1,55)，等定时器工作到55秒后再执行其他操作。系统操作函数!AppActive()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!Beep()函数意义：发出嗡鸣声。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：无。实例：!Beep()。!EnableDDEConnection()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!EnableDDEInput()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!LinePrtOutput()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!PlaySound()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!SendKeys(string)函数意义：将一个或多个按键消息发送到活动窗口，就如同在键盘上进行输入一样。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：string，字符串表达式，指定要发送的按键消息。实例：!SendKeys("%{TAB}")，切换窗口。说明：每个按键由一个或多个字符表示。为了指定单一键盘字符，必须按字符本身的键。例如，为了表示字母A，能够用"A"作为string。为了表示多个字符，就必须在字符后面直截了当加上另一个字符。例如，要表示A、B及C，可用"ABC"作为string。对SendKeys来说，加号(+)、插入符(^)、百分比符号(%)、上划线(~)及圆括号()都具有专门意义。为了指定上述任何一个字符，要将它放在大括号({})当中。例如，要指定正号，可用{+}表示。为了指定大括号字符，请使用{{}及{}}。为了在按下按键时指定那些不显示的字符，例如：ENTER或TAB以及那些表示动作而非字符的按键，请使用以下代码：按键代码BACKSPACE{BACKSPACE},{BS},或{BKSP}BREAK{BREAK}CAPSLOCK{CAPSLOCK}DELorDELETE{DELETE}或{DEL}DOWNARROW{DOWN}END{END}ENTER{ENTER}或~ESC{ESC}HOME{HOME}INSorINSERT{INSERT}或{INS}LEFTARROW{LEFT}NUMLOCK{NUMLOCK}PAGEDOWN{PGDN}PAGEUP{PGUP}RIGHTARROW{RIGHT}SCROLLLOCK{SCROLLLOCK}TAB{TAB}UPARROW{UP}F1{F1}F2{F2}F3{F3}F4{F4}F5{F5}F6{F6}F7{F7}F8{F8}F9{F9}F10{F10}F11{F11}F12{F12}F13{F13}F14{F14}F15{F15}F16{F16}　为了指定那些与SHIFT、CTRL及ALT等按键结合的组合键，可在这些按键码的前面放置一个或多个代码，这些代码列举如下：按键代码SHIFT+CTRL^ALT%为了说明在按下其它按键时应同时按下SHIFT、CTRL、及ALT的任意组合键，请把那些按键的码放在括号当中。例如，为了说明按下E与C的时候同时按下SHIFT键，请使用"+(EC)"。为了说明在按下E的时候同时按下SHIFT键，但接着按C而不按SHIFT，那么使用"+EC"。　注意：不能用SendKeys将按键消息发送到如此一个应用程序，那个应用程序并没有被设计成在MicrosoftWindows中运行。Sendkeys也无法将PRINTSCREEN按键{PRTSC}发送到任何应用程序。!SetLinePrinter(n)函数意义：打开/关闭行式打印输出。返回值：数值型。返回值=0：调用成功；<>0:调用失败。参数：n,数值型，1，表示打开行式打印输出；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)，设置当前系统时刻为2000年1月1日1时1分1秒。!Shell()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!Sleep(mTime)函数意义：在脚本程序中等待mTime毫秒，然后再执行下条语句。只能在策略中使用，否那么会造成系统响应缓慢。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：mTime，数值型，要等待的毫秒数。实例：!Sleep(10)。!TerminateApplication()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!WaitFor(Dat1,Dat2)函数意义：在脚本程序中等待设置的条件满足，脚本程序再向下执行。只能在策略中使用，否那么造成系统响应缓慢。返回值：数值型。返回值=0：调用成功；<>0：调用失败。参数：Dat1，数值型，条件表达式，如：D=15。Dat2，数值型，等待条件满足的超时时刻，单位：ms。为0那么无限等待。实例：!WaitFor〔D=15,12000〕，等变量D的值等于15后，程序再连续执行，假如在12秒后条件仍旧没有满足，也自动连续执行。此函数通常用于做实验时，等待某个条件满足，然后再接着执行实验流程。他与Sleep函数以及While循环语句、其他循环策略配合，能够实现复杂的流程调度。注意：!WaitFor只能用于策略中，而不能直截了当在窗口控件的脚本程序中使用。!WinHelp()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。数学函数!Atn(x)函数意义：反正切函数。返回值：数值型，用弧度表示。参数：x，数值型。实例：!Atn(1)=0.785398。!Cos(x)函数意义：余弦函数。返回值：数值型。参数：x，数值型，用弧度表示。实例：!Cos(3.14159)=-1.0。!Sin(x)函数意义：正弦函数。返回值：数值型。参数：x，数值型，用弧度表示。实例：!Sin(3.14159)=0.0。!Tan(x)函数意义：正切函数。返回值：数值型。参数：x，数值型，用弧度表示。实例：!Tan(3.14159)=0.0。!Exp(x)函数意义：指数函数。返回值：数值型。参数：x，数值型。实例：!Exp(2.3020585093)=10.0。!Log(x)函数意义：对数函数。返回值：数值型。参数：x，数值型。实例：!Log(10)=2.302。!Sqr(x)函数意义：平方根函数。返回值：数值型。参数：x，数值型。实例：!Sqr(4.0)=2.0。!Abs(x)函数意义：绝对值函数。返回值：数值型。参数：x，数值型。实例：!Abs(-3.14159)=3.14159。!Sgn(x)函数意义：符号函数。返回值：数值型。参数：x，数值型。实例：!Sgn(-10)=-1；!Sgn(10)=1；!Sgn(0)=0。!BitAnd(x,y)函数意义：按位与。返回值：开关型。参数：x，开关型，y，开关型。实例：!BitAnd(3,4)=0。!BitOr(x,y)函数意义：按位或。返回值：开关型。参数：x，开关型。y,开关型。实例：!BitOr(3,4)=7。!BitXor(x,y)函数意义：按位异或。返回值：开关型。参数：x，开关型。y,开关型。实例：!BitXor(3,4)=7。!BitClear(x,y)函数意义：清除指定位，位置从0开始运算。返回值：开关型。参数：x，开关型。y,开关型。实例：!BitClear(3,1)=1，把第2位清空。!BitSet(x,y)函数意义：设置指定位，位置从0开始运算。返回值：开关型。参数：x，开关型。y,开关型。实例：!BitSet(3,2)=7。!BitNot(x)函数意义：按位取反。返回值：开关型。参数：x，开关型。实例：!BitNot(0)=0xffffffff。!BitTest(x,y)函数意义：检测指定位是否为一，位置从0开始运算。返回值：开关型。参数：x，开关型。y,开关型。实例：!BitTest(3,2)=0。!BitLShift(x,y)函数意义：左移返回值：开关型。参数：x，开关型。y,开关型。实例：!BitLShift(3,1)=6。!BitRShift(x)函数意义：右移。返回值：开关型。参数：x，开关型。y,开关型。实例：!BitRShift(3,1)=1。!Rand(x,y)函数意义：生成随机数，随机数的范畴在x和y之间。返回值：数值型。参数：x，数值型。y,数值型。实例：!Rand(3,4)=3.1。文件操作函数注意：文件操作函数中所涉及到文件的路径均为绝对路径!FileAppend(strTarget,strSource)函数意义：将文件strSource中的内容添加到文件strTarget后面，使两文件合并为一个文件。返回值：开关型。参数：strTarget，字符型，目标文件，需要写绝对路径；strSource，字符型，源文件，需要写绝对路径。实例：!FileAppend("d:\a.txt","d:\b.txt")。实例说明：将D盘下文件b.txt合并到文件a.txt的后面。假设a.txt不存在，那么会自动新建一个文件。!FileCopy(strSource,strTarget)函数意义：将源文件strSource复制到目标文件strTarget，假设目标文件已存在，那么将目标文件覆盖。返回值：开关型；返回0，操作不成功；返回非0值，操作成功。参数：strSource，字符型，源文件；strTarget，字符型，目标