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

《MCGS嵌入版运行环境操作函数》由会员分享，可在线阅读，更多相关《MCGS嵌入版运行环境操作函数（87页珍藏版）》请在装配图网上搜索。

1、MCGS 嵌入版运行环境操作函数运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时刻。返 回 值：数值型。返回值 =0：调用正常， 0：调用不正常。参数： StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时刻。实例： !ChangeLoopStgy(报警策略 ,5000)，将报警策略的循环时刻改为 5 秒。!CloseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开那个窗口，关闭其他窗口。如果”WndName”为空串，则关闭所有窗口。返 回 值：数值型。返回值：

2、=0：调用正常。 0：调用不正常。参数： WndName， 用户窗口名，字符型。实例： !CloseAllWindow( 工况图 )，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloseAllWindow() ，关闭所有窗口。!CloseAllSubWnd()函数意义：关闭窗口中的所有子窗口。返 回 值：浮点型， =0 为操作。实例： !CloseAllSubWnd() ，关闭当前窗口的所有子窗口。!CloseSubWnd（WndName）函数意义：关闭子窗口。返 回 值：浮点型， =1 为操作成功， 1 为操作失败。参 数 值：

3、WndName：子窗口的名字。实例： !CloseSubWnd(窗口 1)，关闭子窗口“窗口1”。!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。返 回 值：数值型。返回值 =0：调用正常， 0：调用不正常。参数： SstgyName，策略名；n，数值型，为1 时表示打开此策略，为0 时表示关闭此策略。实例： !EnableStgy(报警策略 ,1)， 打开报警策略；!EnableStgy(报警策略 ,0)， 关闭报警策略，使报警策略无效。!GetDeviceName(Index)函数意义：按设备顺序取到设备的名字。返 回 值：字符型。调用成

4、功返回设备名，调用失败时返回空字符串。参数： Index，数值型。实例： !GetDeviceName(0) ，取 0 号设备构件的名称。!GetDeviceState(DevName)函数意义：按设备名查询设备的状态。返 回 值：数值型。=-1 调用不正常。=1 设备处于正常的工作状态。=2 设备正在工作，但设备不正常。=3 设备处于停止工作状态，且设备正常。=4 设备处于停止状态，且设备有错。参数： DevName，设备名，字符型。实例： !GetDeviceState(OmronPLC)，读取设备构件“ OmronPLC”的当前工作状态。注意：设备名称是在设备构件差不多属性页中设置的。!

5、GetLastMouseActionTime()函数意义：猎取最后一次鼠标的动作发生的时刻。返 回 值：开关型。返回为time_t 类型的时刻值，能够在时刻操作脚本函数中使用。参数：无。实例：在画面，系统对话框上的鼠标事件中添加!GetLastMouseActionTime() ，猎取鼠标最后动作时刻。!GetStgyName(Index)函数意义：按运行策略的顺序获得各策略块的名字。返 回 值：字符型。参数： Index，数值型。实例： !GetStgyName(0)，取 0 号运行策略的名称。!GetWindowName(Index)函数意义：按用户窗口的顺序获得用户窗口的名字。返 回 值

6、：字符型。参数： Index， 数值型。实例： !GetWindowName(0) ，读取 0 号用户窗口的名称。!GetWindowState(WndName)函数意义：按照名字取得用户窗口的状态。返 回 值：数值型。返回 0：用户窗口处于关闭状态。返回 1：用户窗口处于打开状态。返回 2：用户窗口处于隐藏状态。参数： WndName，用户窗口名称，字符型。实 例：!GetWindowState(工况图 )，获得用户窗口 “工况图”的状态。!OpenSubWnd（参数 1,参数 2，参数 3，参数 4，参数 5，参数 6）函数意义：显示子窗口。返 回 值：字符型，如成功就返回子窗口n，n表示

7、打开的第n 个子窗口。参 数 值：参数 1：要打开的子窗口名。参数 2：整型，打开子窗口有关于本窗口的X 坐标。参数 3：整型，打开子窗口有关于本窗口的Y 坐标。参数 4：整型，打开子窗口的宽度。参数 5：整型，打开子窗口的高度。参数 6：整型，打开子窗口的类型。0 位：是否模式打开，使用此功能，必须在此窗口中使用CloseSubWnd 来关闭本子窗口，子窗口外不的构件对鼠标操作不响应1 位：是否菜单模式，使用此功能，一旦在子窗口之外按下按钮，则子窗口关闭。2 位：是否显示水平滚动条，使用此功能，能够显示水平滚动条3 位：是否垂直显示滚动条，使用此功能，能够显示垂直滚动条4 位：是否显示边框，

8、选择此功能，在子窗口周围显示细黑线边框5 位：是否自动跟踪显示子窗口，选择此功能， 在当前鼠标位置上显示子窗口。此功能用于鼠标打开的子窗口， 选用此功能则忽略 iLeft,iTop 的值，如果现在鼠标位于窗口之外，则在窗口对中显示子窗口6 位：是否自动调整子窗口的宽度和高度为缺省值， 使用此功能则忽略iWidth 和 iHeight 的值。子窗口的关闭方法：使用关闭窗口直截了当关闭，则把整个系统中使用到的此子窗口完全关闭使用指定窗口的 CloseSubWnd 关闭，能够使用 OpenSubWnd返回的控件名，也能够直截了当指定子窗口关闭，现在只能关闭此窗口下的子窗口。!SetActiveX()

9、函数讲明：此函数在嵌入版中无效，考虑兼容性咨询题，故保留。!CallBackSvr()函数讲明：此函数在嵌入版中无效，考虑兼容性咨询题，故保留。!SetDevice(DevName,DevOp,CmdStr)函数意义：按照设备名字对设备进行操作。返 回 值：数值型。返回值： =0：调用正常。 0：调用不正常。参数： DevName，设备名，字符型；DevOp，设备操作码，数值型；CmdStr，设备命令字符串，只有当DevOp=6 时 CmdStr 才有意义。DevOp 取值范畴及相应含义：1：启动设备开始工作。2：停止设备的工作使其处于停止状态。3：测试设备的工作状态。4：启动设备工作一次。5

10、：改变设备的工作周期，CmdStr 中包含新的工作周期，单位为ms。6：执行指定的设备命令，CmdStr 中包含指定命令的格式。实例：!SetDevice(OmronPLC,1, )，启动设备构件“ OmronPLC”开始工作。!SetMousePace(开关型 )函数意义：设置鼠标灵敏度。参 数：开关型参数为每次按键消息需要设置的鼠标移动间隔，一样情形下请输入正整数，如果输入 0 值表示禁止该功能实例： !SetMousePace(1);默认情形下该功能为关闭状态， 鼠标灵敏度为 0，如果想启用该功能在启动策略中调用 !SetMousePace脚本函数指定步长值。!SetNumPanelSi

11、ze(Type,Size)函数意义：按照需要和显示屏的大小调整软键盘的大小。返 回 值：开关型。返回值 =0：修改成功。新设置将在下一次打开输入键盘时生效。返回值 =1：修改失败，参数错误。 （可能是没有匹配的type ，或者 size 参数超出范畴）。参 数： Type，键盘类型，数值型；1：代表修改数值输入键盘。2：代表修改字符输入键盘； 。3：代表修改用户登录对话框。Size，键盘大小，数值型；数值范畴：200 像素 1024 像素；实例：!SetNumPanelSize(1,500)，将数值输入键盘改为500*500 大小，该正方形有关于屏幕居中。所有修改将在下一次打开输入框时生效，运

12、行环境退出后，将自动保留上次输入框的大小。注意事项：键盘放大缩小功能在重新下载工程时没有删除配置文件，换工程后设置仍旧有效，除非重新进行了设置。如果要去掉原先的设置则需要手工删除 panelSize.ini 文件，该文件位于 harddiskmcgsbin 名目下。!SetStgy(StgyName)函数意义：执行StgyName指定的运行策略。返 回 值：数值型。返回值 =0：调用正常， 0：调用不正常。参数： StgyName，策略名，字符型。实例： !SetStgy(阀门关闭 )，执行一次运行策略“阀门关闭” 。!SetWindow(WndName,Op)函数意义：按照名字操作用户窗口，

13、如打开、关闭、打印。返 回 值：数值型。返回值： =0：调用正常。 0：调用不正常。参数： WndName， 用户窗口名，字符型。 Op: 操作用户窗口的方法，数值型。Op=1：打开窗口并使其可见。Op=2：打开窗口并使其不可见。Op=3：关闭窗口。Op=4：打印窗口。Op=5：刷新窗口。实例： !SetWindow(工况图 ,1)，打开用户窗口“工况图” ，并使其可见。!SysWindow()函数意义：执行该函数后，打开用户窗口治理窗口，在治理窗口中能够选择打开或关闭指定的用户窗口。返 回 值：数值型。返回值 =0：调用成功； 0：调用失败。参数：无。实例： !SysWindow() 。!S

14、etStyMode(StgyName)函数意义：通过脚本函数（位于系统函数 -运行环境类）实现函数调用方式的策略调用。返回 ：开关型，返回 恒 0。参数： StgyName，策略名，字符型。 例： !SetStgyMode( 关 )， 行一次运行策略“ 关 ” ，“ 关 ”策略 行完 后，才返回 用者， 用者 行以下程序。!GetCurrentLanguageIndex( )函数意 ：用于 取当前使用的 言的索引 。返 回 ：开关型。返回 言 索引 。索引 按照 下拉框依次排序 0，1，2参数： 无。 例： N=!GetCurrentLanguageIndex( ) ，其中 N 开关型 量。!

15、SetCurrentLanguageIndex ( 开关型)函数意 ：通 索引 定当前 言 境返 回 ：开关型。返回 0 表示 行成功，否 表示失 。参数：开关型。 言索引 。如果索引参数 超出当前 言范畴，那么函数不生效。 例：!SetCurrentLanguageIndex(1)，表示 置当前 言 英文 （ 言 CH，EN）。!GetLocalLanguageStr( 开关型)函数意 ： 得指定自定 ID 的当前 言的内容。返 回 ：字符型。参数：开关型。自定 ID 索引 。如果无当前ID 自定 文本， 返回空 。 例：!GetLocalLanguageStr（2），前提是有 ID 为 2

16、 的自定 文本内容，如果当前 言 英文， 返回 ID 为 2 的自定 文本 的英文内容。!GetLanguageNameByIndex(开关型 )函数意义：按照语言索引值返回语言名称，返回值为字符型。返 回 值：字符型，当前语言的名称。参 数：开关型。语言的索引值。如果当前索引值无对应语言，则返回空值。实 例： !GetLanguageNameByIndex(1) ，如果当前语言为中文、英文，则返回值为 English。数据对象操作函数!AnswerAlm(DatName)函数意义：应答数据对象DatName 所产生的报警。如对应的数据对象没有报警产生或差不多应答，则本函数无效。返 回 值：数

17、值型， =0 为操作成功， 0 为操作失败。参数： DatName，数据对象名。实例： !AnswerAlm( 电机温度 )，应答数据对象“电机温度”所产生的报警。!ChangeDataSave(Datname,n)函数意义：改变数据对象Datname存盘的周期。返 回 值：数值型， =0 为操作成功， 0 为操作失败。参数： Datname，数据对象名； n，数值型，以秒表示的存盘间隔时刻。实例：!ChangeDataSave(温度 ,5)，温度的存盘间隔时刻为5 秒。!ChangeSaveData(DatName,Num1,Num2)该函数在通用版中能够使用，在嵌入版中不能使用！函数意义：

18、改变数据对象DatName 所对应存盘数据的存盘间隔，把Num1 小时往常的存盘数据（以当前时刻为 0 点）的存盘间隔改为 Num2 秒。本操作只对组对象有效，对单个的数据对象无效。当 DataName =空字符，或 Num1=0 或 Num2=0 时，本操作无效。返 回 值：数值型，返回值 =0：调用正常， 0：调用不正常。参数： DatName：数据对象名。Num1：数值型时刻量，单位：小时。本函数用 Num10 的一些数值来表示一些专门意义的操作：=-1 改变当天对应数据对象所有存盘数据的存盘间隔； =-2 改变昨天对应数据对象所有存盘数据的存盘间隔； =-3 改变本星期对应数据对象所有

19、存盘数据的存盘间隔； =-4 改变上星期对应数据对象所有存盘数据的存盘间隔； =-5 改变本月对应数据对象所有存盘数据的存盘间隔； =-6 改变上个月对应数据对象所有存盘数据的存盘间隔；Num2：数值型时刻量，新的存盘间隔，单位：秒。实例：!ChangeSaveData(电机 1,-2,5)，把组对象“电机 1”对应的存盘数据中昨天的存盘数据的存盘间隔改为5 秒钟。!FlushDataInitValueToDisk()函数意义：把所有数据对象的初始值写入磁盘。返 回 值：数值型，返回值 =0：调用正常， 0：调用不正常。参数：无。!CopySaveDat()函数讲明：此函数在嵌入版中无效，考虑

20、兼容性咨询题，故保留。!DelSaveDat(DatName,Num)函数意义：删除组对象 DatName 对应的存盘数据中最早 Num 小时内的存盘数据，如果 Num 0, 就删除以当前时刻为基点 Num 个小时之前的内容 ,删除时是按文件删除的，如果数据不足一个存盘文件，是可不能被删除的。返 回 值：数值型，返回值 =0：调用正常， 0：调用不正常。参数： DatName，组对象名。Num , 参数名。实 例： !DelSaveDat(电机温度， 12) ，删除组对象“电机温度”对应的存盘数据中以当前时刻为基点倒推 12 个小时之前的数据。但从当前时刻至倒推的 12 个小时之内的内容会被储

21、存。注意：该函数只对组对象操作有效。!DelAllSaveDat()函数意义：删除组对象 DataName对应的所有存盘数据。 注意，此函数不能用来删除组对象所对应的报警存盘数据。返 回 值：数值型，返回值 =0：调用正常， 0：调用不正常。参数： DatName：组对象名；实例： !DelAllSaveDat （电机温度），删除组对象“电机温度”对应的所有存盘数据注意：该函数只对组对象操作有效。!EnableDataSave(name,n)函数意义：打开 /关闭数据对象的定时存盘功能。返 回 值：数值型，返回值 =0：调用正常， 0：调用不正常。参数： name，数据对象名；n，数值型， 1

22、 表示打开定时存盘， 0 表示关闭定时存盘。实例： !EnableDataSave(温度 ,1)， 打开温度的定时存盘。!ExportHisDataToCSV(文件名 ,组对象名 ,字段名 ,开始时刻 ,终止时刻 ,最大记录数 ,导出模式 ,导出参数 ,进度指示数据对象名 ,取消操纵数据对象名 )函数意义：1.导出指定组对象存盘数据，导出的条件包括：开始时刻-终止时刻，最大导出总条数 ;2.导出字段列表，组对象为MCGS_ALARM 则表示导出报警历史数据；3.可指定导出文件名和路径，要紧是U 盘导出，能够追加方式也可覆盖方式导出；4.可显示导出过程进度情形；5.可取消和中止长时刻的导出过程；

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

24、开始时刻，终止时刻：用表示的时刻字符串“YYYY-MM-DDHH：MM ：SS”；最大记录数：期望导出的最大记录数，超过该记录数就返回，停止导出；导出模式：“1”表示覆盖现有文件， “2”表示追加到文件最后；导出参数：临时为空，保留以后使用；进度指示数据对象名：开关型数据对象，导出过程中该对象值反映出当前已导出记录条数，如果导出过程中其他专门终止则通过该对象返回同函数返回错误码；进度指示错误码：返回 -1- 文件不能打开返回 -2- 没有可导出的数据返回 -4- 文件操作显现错误操纵数据对象名：指定一个开关型数据对象,该对象操纵导出执行，启动导出时会自动设置该变量为0，用户在导出过程中想取消导

25、出则能够设置该值为 0 的任何值，导出函数运行终止后会自动设置对象值为1；进度指示错误码：返回 0- 导出成功返回 -1- 导出路径不存在返回 1- 指定组对象错误，可能组对象没有储存历史数据或者没有该组对象返回 2- 指定的时刻格式错误返回 3- 指定的无效的数据对象名返回 4- 无效的导出模式返回 5- 同时只能支持一个csv 导出实例: ret= !ExportHisDataToCSV(usb harddiskyang.csv,group,data1,data4,2007/1/1 0:0:0,2009/1/1 0:0:0,20000,1,进度 ,操纵 )!GetAlmValue(DatN

26、ame,Value,Flag)函数意义：读取数据对象DatName 报警限值，只有在数据对象DatName 的“承诺进行报警处理”属性选项被选中后，本函数的操作才有意义。对组对象、字符型数据对象、事件型数据对象本函数无效。对数值型数据对象，用 Flag 来标识读取何种报警限值。返 回 值：数值型，返回值 =0：调用正常， 0：调用不正常。参数： DatName：数据对象名。Value：DataName的当前的报警限值，数值型。Flag：数值型，标志要读取何种限值，具体意义如下：=1 下下限报警值；=2 下限报警值；=3 上限报警值；=4 上上限报警值；=5 下偏差报警限值；=6 上偏差报警限值

27、；=7 偏差报警基准值；实例:!GetAlmValue( 电机温度 ,Value,3)，读取数据对象“电机温度”的报警上限值，放入数值型数据对象Value 中。!GetEventDT()函数讲明：此函数在嵌入版中无效，考虑兼容性咨询题，故保留。!GetEventP()函数讲明：此函数在嵌入版中无效，考虑兼容性咨询题，故保留。!GetEventT()函数讲明：此函数在嵌入版中无效，考虑兼容性咨询题，故保留。!MoveSaveDat()函数讲明：此函数在嵌入版中无效，考虑兼容性咨询题，故保留。!SaveData(DatName)函数意义：把数据对象 DataName对应的当前值存入存盘数据库中。本

28、函数的操作使对应的数据对象的值存盘一次。此数据对象必须具有存盘属性，且存盘时刻需设为0 秒。否则会操作失败。返 回 值：数值型， =0 为操作成功， 0 为操作失败。参数： DatName，数据对象名。实例：!SaveData(电机 1)，把组对象“电机 1”的所有成员对应的当前值存盘一次。!SaveDataInit()函数意义：本操作把设置有“退出时自动储存数据对象的当前值作为初始值”属性的数据对象的当前值存入组态结果数据中作为初始值，防止突然断电而无法储存，以便MCGS 嵌入版下次启动时这些数据对象能自动复原其值。返 回 值：数值型，返回值 =0：调用正常， 0：调用不正常。参数：无。实例

29、： !SaveDataInit()。注意：此函数单独使用不起作用，需要和函数!Flushdatainitvaluetodisk()一起使用。!SaveDataOnTime(Time,TimeMS,DataName)函数意义：使用指定时刻储存数据。本函数通常用于指定时刻来储存数据，实现与通常机制不一样的存盘方法。返 回 值：数值型，返回值 =0：调用正常， 0：调用不正常。参数： Time，数值型，使用时刻函数转换出的时刻量。时刻精度到秒。TimeMS，数值型，指定存盘时刻的毫秒数。实例： t =!TimeStr2I(2001 年 2 月 21 日 3 时 2 分 3 秒) ；!SaveData

30、OnTime (t,0,DataGroup)， 按照指定时刻储存数据对象。!SaveSingleDataInit(Name)函数意义：本操作把数据对象的当前值设置为初始值（不管该对象是否设置有“退出时自动储存数据对象的当前值作为初始值”属性），防止突然断电而无法储存，以便MCGS 嵌入版下次启动时这些数据对象能自动复原其值。返 回 值：数值型，返回值 =0：调用正常， 0：调用不正常。参数： Name，数据对象名。实例： !SaveSingleDataInit(温度 )，把温度的当前值设置成初始值。!SetAlmValue(DatName,Value,Flag)函数意义：设置数据对象DatNa

31、me 对应的报警限值，只有在数据对象DatName“承诺进行报警处理”的属性被选中后，本函数的操作才有意义。对组对象、字符型数据对象、事件型数据对象本函数无效。对数值型数据对象，用 Flag 来标识改变何种报警限值。返 回 值：数值型，返回值 =0：调用正常， 0：调用不正常。参数： DatName：数据对象名。Value：新的报警值，数值型。Flag：数值型，标志要操作何种限值，具体意义如下：=1 下下限报警值；=2 下限报警值；=3 上限报警值；=4 上上限报警值；=5 下偏差报警限值；=6 上偏差报警限值；=7 偏差报警基准值；实例：!SetAlmValue(电机温度 ,200,3)，把

32、数据对象 “电机温度”的报警上限值设为200!TransToUSB(组对象名 ,起始时刻 ,终止时刻 ,导出状态 ,进度指示 ,转出模式,保留参数 )函数意义：将 XXX 组对象的存盘数据导出到USB HARDDISK 名目下，储存为“ XXX.csv ”文件，模拟环境则是储存到与可执行文件相同路径下。返 回 值：开关型。0：参数没有错误。1：第一个参数错误。（请检查是否组对象名称，或“MCGS_ALARM ”）2: 时刻参数格式错误。3：状态变量的类型错误。 （两个变量都必须是开关量）5：同时只能支持一个csv 导出。参数：组对象名：字符型，要导出的组对象名称（或“MCGS_ALARM ”）

33、。起始时刻：字符型，要导出的历史数据的开始时刻，格式： YYYY-M M-DD HH:MM:SS 。终止时刻：字符型，要导出的历史数据的终止时刻，格式：YYYY-MM-DDHH:MM:SS 。导出状态：开关型，进度指示数据对象名（开关量），输出导出状态。正常导出存盘后输出当前差不多导出的记录条数。当创建导出文件“ XXX.csv ”失败时输出 1。（请检查下位机是否正常插入了U 盘）当前没有记录可导出时输出2。（请检查对应的组对象是否有存盘信息，或者开始时刻终止时刻是否设置正确）导出过程中显现未知数据类型时输出3。（不应该显现）导出过程中显现文件操作专门时输出4。（请检查U 盘容量是否足够）进

34、度指示：开关量，指定一个数字型或开关型对象,该对象操纵导出执行，启动导出时会自动设置该变量为 0，用户在导出过程中想取消导出可设置该变量为 0 的任何值，导出函数运行终止后会自动设置对象值为 1。注： 6.5（01.0010）之前的版本，此参数为原导出状态变量 2，显示的是导出数据总条数。转出模式：开关型，保留，设置为0。保留参数：字符型，保留, 设置为空字符串。实例：!TransToUSB(MCGS_ALARM, 2008-12-1 00:00:00 , 2008-12-31 00:00:00 , Switch01 , Switch02 , 0 , ) 。注意事项：该函数最多只能导出3000

35、0 条记录。当满足导出时刻条件的记录数大于 30000 时，只导出前 30000 条记录。!CopyDateFileToDisk(pathName,dataType,copyState)函数意义 : 拷贝当前运行工程的数据到指定的名目pathName中。返 回 值:1：在拷贝的过程中 ,数据对象 copyState,由 0 转变为非 0.表示用户不想连续拷贝。0：表示拷贝成功。-1：当前工程中 ,当前运行工程中没有组对象要存盘。-2：创建名目 pathName失败。-3：创佳索引文件 MCGS_DATA.ini 失败或者对此文件进行写操作失败。-4：参数 dataType的值 ,不正确 ,目前

36、只支持值为0。-5：磁盘空间不足。-6：参数 copyState不是数据对象类型。-7：参数 copyState是数据对象类型 ,但不是开关型数据对象。-8：参数 copyState在一开始调用此脚本时,就为非 0。参数讲明 :pathName：字符串型 .要拷贝数据到此的路径名.例如 :在模拟环境能够写d:test,在运行环境可写 harddisktest。dataType：开关型 .拷贝数据的类型 ,0 表示历史数据 ,1 表示报警数据 .目前只支持拷贝历史数据,报警数据还没有处理。copyState：数据对象型 .是否拷贝的标志 .当为 0 表示能够拷贝 ,为非 0 表示取消当前的拷贝。

37、实例： !CopyDateFileToDisk(harddisktest,0,copyState) 把当前工程中历史数据拷贝到名目 harddisktest中(如 copyState为 0 表示拷贝 ,为非表示取消 )。讲 明：一样此脚本要配合组态环境中的一个小程序 DataTrans. exe 来一起操作 .把拷贝的数据名目 ,通过 U 盘或其他方式 ,导到上位机 (PC), 通过用程序 DataTrans.exe来进行数据的转换。用户登录操作函数!ChangePassword()函数意义：弹出密码修改窗口，供当前登录的用户修改密码。返 回 值：数值型。返回值 =0：调用成功； 0：调用失败

38、。参数：无。实例： !ChangePassword()。!CheckUserGroup(strUserGroup)函数意义：检查当前登录的用户是否属于strUserGroup 用户组的成员。返 回 值：数值型。返回值 =0：调用成功； 0：调用失败。参数： strUserGroup，字符型，用户组的名称。实例： !CheckUserGroup(治理员组 ) 。!Editusers()函数意义：弹出用户治理窗口，供治理员组的操作者配置用户。返 回 值：数值型。返回值 =0：调用成功； 0：调用失败。参数：无。实例： !Editusers()。!EnableExitLogon(n)函数意义：打开

39、/关闭退出时的权限检查。返 回 值：数值型。返回值 =1：操作成功；返回值 =0：操作失败。参数：n，数值型，为 1 时表示在退出时进行权限检查，当权限不足时，会进行提示。为0 则退出时不进行权限检查。实例： !EnableExitLogon(1)， 在退出时进行权限检查。!EnableExitPrompt(n)函数意义：打开 /关闭退出时的提示信息。返 回 值：数值型。返回值 =0：调用成功； 0：调用失败。参数：n，数值型，为 1 时表示在退出时弹出提示信息对话框。为0 则退出时不显现信息对话框。实 例： !EnableExitPrompt(1)， 在退出时弹出提示信息对话框。!GetCu

40、rrentGroup()函数意义：读取当前登录用户的所在用户组名。返 回 值：字符型，当前登录用户组名，如没有登录返回空。参数：无。实例： !GetCurrentGroup()。!GetCurrentUser()函数意义：读取当前登录用户的用户名。返 回 值：字符型，当前登录用户的用户名，如没有登录返回空。参数：无。实例： !GetCurrentUser()。!LogOff()函数意义：注销当前用户。返 回 值：数值型。返回值 =0：调用成功； 0：调用失败。参数：无。实例： !LogOff() 。!LogOn()函数意义：弹出登录对话框。返 回 值：数值型。返回值 =0：调用成功； 0：调用

41、失败。参数：无。实例： !LogOn() 。字符串操作函数!Ascii2I(s)函数意义：返回字符串s 的首字母的 Ascii 值。返 回 值：开关型。参数： s， 字符型。实例： !Ascii2I(Afd)=65 。!Bin2I(s)函数意义：把二进制字符串转换为数值。返 回 值：开关型。参数： s， 字符型。实例： !Bin2I(101)=5 。!Format(n,str)函数意义：格式化数值型数据对象。返 回 值：字符型。参数： n，数值型，要格式化的数值；str，字符型，格式化数值的格式。表示为 0.00 样式。小数点后的 0 的个数表示需要格式化出的小数位数。小数点前的 0 为一个时

42、，表示小数点前按照 实际数值显示。当小数点前没有 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”。!I2

43、Bin(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，字符串

44、，要搜索的字符串。实例： !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

45、(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，数值型，取字符

46、数。实例： !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)函数意

47、义：将数值型数据对象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

48、.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 。!Va

49、l(str)函数意义：把字符型数据对象str 的值转换成数值。返 回 值：数值型。参数： str， 字符型。实例： !Val(0.712) = 0.712。定时器操作函数可用的系统定时器范畴为 1 到 127，即系统内嵌 127 个系统定时器。 用户能够随意使用其中的任意一个。定时器返回时刻值为数值型，单位为秒 ,分，时，然而小数位最多能够表示到毫秒。因为采纳浮点数表示，随着数值增大会略有误差。!TimerClearOutput(定时器号 )函数意义 : 清除定时器的数据输出连接。返 回 值：数值型。返回值 =0：调用成功； 0：调用失败。参数：定时器号。实例： !TimerClearOutp

50、ut(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)函数意义：取定时器的当前值。返 回 值：将定时器的值以数值型的方式输出（数值格式）。参数：定时器号。