发布时间 : 星期二 文章MCGS系统内部函数参考手册更新完毕开始阅读
Flag=0时，创建一个新文件(如原文件已存在，则把原文件改名为***.BK1)；Flag=1时，在原有的基础上增加新的数据。
实 例：!MoveAlmDat(电机温度， \，-6，0，1)，把数据对象“电机温度”对应的报警存盘数据中的上个月的所有报警信息存盘数据转存添加到数据库文件\中。
!MoveSaveDat(DatName，FileName，Num1，Num2，Flag)
函数意义：把数据对象DatName所对应的存盘数据中的第Num1小时到Num1+Num2小时内（以当前时间为0点）的存盘数据提取出来，转存到FileName所指定的数据库文件中（Access数据库）。当DatName=空字符，或FileName=空字符，或Num2<0时，本函数无效。
返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：DatName：数据对象名。
FileName：新的存盘数据文件名(包括路径)，字符型。 Num1：数值型时间量，单位：小时。
本函数用Num1<0的一些数值来表示一些特殊意义的操作（此时Num2无效）： =-1 转存当天对应数据对象的所有存盘数据； =-2 转存昨天对应数据对象的所有存盘数据； =-3 转存本星期对应数据对象的所有存盘数据； =-4 转存上星期对应数据对象的所有存盘数据； =-5 转存本月对应数据对象的所有存盘数据； =-6 转存上个月对应数据对象的所有存盘数据； Num2：数值型时间量，单位：小时。 Flag：转存标志，数值型。
Flag=0时，创建一个新文件(如原文件已存在，则把原文件改名为***.BK1)；Flag=1时，在原有的基础上增加新的数据。
实 例：! MoveSaveDat(电机温度， \，-6，0，1) 把数据对象“电机温度”对应的存盘数据中的上个月的所有存盘数据转存添加到数据库文件“D:\\Temp\\ttt.mdb”中。 !SaveData(DatName)
函数意义：把数据对象DataName对应的当前值存入存盘数据库中。本函数的操作使对应的数据对象的值存盘一次。此数据对象必须具有存盘属性，且存盘时间需设为0秒。否则会操作失败。
返 回 值：数值型，=0为操作成功；<>0为操作失败。 参 数：DatName，数据对象名。
9
实 例：! SaveData(电机1)，把组对象“电机1”的所有成员对应的当前值存盘一次。 !SaveDataInit()
函数意义：本操作把设置有“退出时自动保存数据对象的当前值作为初始值”属性的数据对象的当前值存入组态结果数据中作为初始值，防止突然断电而无法保存，以便MCGS下次启动时这些数据对象能自动恢复其值。 返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：无。
实 例：! SaveDataInit()
!SaveDataOnTime(Time，TimeMS,DataName)
函数意义：使用指定时间保存数据。本函数通常用于指定时间来保存数据，实现与通常机制不一样的存盘方法。
返 回 值：数值型，返回值=0：调用正常；<>0：调用不正常。 参 数：Time，整型，使用时间函数转换出的时间量。时间精度到秒。 TimeMS，整型，指定存盘时间的毫秒数。 DataName， 数据对象名。
实 例：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：数值型，标志要操作何种限值，具体意义如下：
10
=1下下限报警值； =2下限报警值； =3上限报警值； =4上上限报警值； =5下偏差报警限值； =6上偏差报警限值； =7偏差报警基准值；
实 例：! SetAlmValue(电机温度， 200， 3)，把数据对象“电机温度”的报警上限值设为200
用户登录操作函数
!ChangePassword()
函数意义：弹出密码修改窗口，供当前登录的用户修改密码。 返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：无。
实 例：!ChangePassword() !CheckUserGroup(strUserGroup)
函数意义：检查当前登录的用户是否属于strUserGroup用户组的成员。 返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：strUserGroup，字符型，用户组的名称。 实 例：! CheckUserGroup(\管理员组\!Editusers()
函数意义：弹出用户管理窗口，供管理员组的操作者配置用户。 返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：无。
实 例：!Editusers() !EnableExitLogon(n)
函数意义：打开/关闭退出时的权限检查 返 回 值：无
参 数：n，数值型，为1时表示在退出时进行权限检查，当权限不足时，会进行提示。为0则退出时不进行权限检查。
实 例：!EnableExitLogon(1)， 在退出时进行权限检查 !EnableExitPrompt (n)
函数意义：打开/关闭退出时的提示信息
11
返 回 值：无
参 数：n，数值型，为1时表示在退出时弹出提示信息对话框。为0则退出时不出现信息对话框。
实 例：!EnableExitLogon(1)， 在退出时弹出提示信息对话框 !GetCurrentGroup()
函数意义：读取当前登录用户的所在用户组名。
返 回 值：字符型，当前登录用户组名，如没有登录返回空。 参 数：无。
实 例：!GetCurrentGroup() !GetCurrentUser()
函数意义：读取当前登录用户的用户名。
返 回 值：字符型，当前登录用户的用户名，如没有登录返回空。 参 数：无。
实 例：!GetCurrentUser() !LogOff()
函数意义：注销当前用户。
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：无。 实 例：!LogOff() !LogOn()
函数意义：弹出登录对话框。
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：无。 实 例：!LogOn() !GetUserNameByIndex()
函数意义：按索引号取得当前用户名。
返 回 值：字符型。与索引号相对应的当前用户名。 参 数：索引号值。
实 例：!GetUserNameByIndex(0) ,索引为0的用户名称。 !GetGroupNameByIndex()
函数意义：按索引号取得当前用户组名。
返 回 值：字符型。与索引号相对应的当前用户组名。 参 数：索引号值。
实 例：!GetGroupNameByIndex(0) ,索引为0的用户组名称。
12