396
第三章脚本函数
脚本函数由力控预先定义，可在界面系统中的动作脚本和动画连接中引用。目前提供的脚本函数类包括：系统、数学、配方、SQL查询、设备操作、字符串操作、Window控件、
内置数据表、其他类函数。
“系统”类和“其它”类包含数据转换、文件操作、系统功能调用、对象操作等功能函数。“数学”类包含一组常用数学运算函数；
“配方”类包含一组用于控制配方管理器的函数；
“SQL查询”类包含一组用于实现SQL访问功能的函数；
“设备操作”类包含一组实现计算机I/O读写操作的函数；
“字符串操作”类包含一组对字符串进行操作的函数。
“Windows控件”类包含一组对力控Windows控件对象（如表格，下拉框等）进行操作的函数。
“内置数据表”类包含一组对内置数据表进行操作的函数。
1、系统函数
AlmAck
语法AlmAck()
说明当前最新报警确认，当前最新报警显示在系统
报警窗右侧。要显示系统报警窗，首先要选中
系统参数中系统报警检查框。
参数
返回值
备注
示例AlmAck();
AlmAckAll
语法AlmAckAll(DataSourceNo,AreaNo)
说明对数据库中某一区域报警进行确认。
DataSourceNo数据源号，类型为整型，序号从0
开始。
AreaNo指定区域号,-1表示所有区域。
参数
返回值
备注
示例AlmAckAll(0,-1);//对整个数据库报警进行确
第三章脚本函数397
认。
Beep
语法beep(number)
说明蜂鸣器发出叫声。
参数参数number用于指定不同的音响。
-1,0：为两种报警声。
1~7对应乐谱的中音1至7。
8~14对应乐谱的高音1至7。
返回值
备注
示例beep(-1); //标准报警声。
ChangeGroup
语法ChangeGroup（GroupNumber）
说明该函数用于历史趋势、实时趋势、模板中的变
量成组替换，替换量一般为DB变量。
参数为数值常量或数值表达式，该参数的值表示变
量组的组号。
返回值
备注对于模板对象，只是替换位号名，参数部份保
留不变。
示例ChangeGroup（2）;//该函数将实时趋势、历史
趋势和模板中的变量分别替换成序号为2的变
量组中的变量。
ChangeTag
语法ChangeTag(OldTag,NewTag)
说明替换位号，该函数用于模板变量的替换，替换量
一般为ＤＢ变量．注意这里只是替换位号名，
参数部分保留不变。
参数OldTag 为字符串常量或字符串表达式，该参
数为被替换量．
NewTag 为字符串常量或字符串表达式，该参
398 第三部分参考手册
数为替换量．
返回值
备注
示例ChangeTag("T1","LIC504") //该函数将模板中
的位号Ｔ１，替换成数据库中的实际位号ＬＩ
Ｃ５０４．如模板中有如下变量
T1.PV,T1.SP,T1.OP,TI.EU等，替换后将变为
字符串常量需要new吗
LIC504.PV,LIC504.SP,LIC504.OP,LIC504.EU.
ChangeTagByNo
语法ChangeTagByNo(no,"NEWTAG")
说明该函数用于模板变量的替换，替换量一般为Ｄ
Ｂ变量．注意这里只是替换位号名，参数部分
保留不变．
参数no为数字常量或数字表达式，为在实时趋势，
历史趋势中变量的序号与组号相同，模板中变
量的序号与在模板变量替换框中所看到的顺序
相同．双击模板对象便出现模板变量替换框
NewTag 为字符串常量或字符串表达式，该参
数为替换量．
返回值
备注
示例ChangeTagByNo(1,＂ＬＩＣ５０４＂)//该函
数将趋势／模板中的序号为１的变量替换成数
据库中的实际位号ＬＩＣ５０４．
CloseWindow
语法CloseWindow（）
说明关闭当前窗口，一般用于弹出式窗口的关闭。参数
返回值
备注
示例CloseWindow（）;
第三章脚本函数399
Delay
语法Delay(millionsec)
说明时间延迟
参数millionsec: 数值常量或数值表达式，表示延
迟的毫秒数。
返回值
备注
示例Delay(1000);//延迟１秒。
DisableOperate
语法DisableOperate (flag)
说明禁止用户对变量的操作。
参数flag禁止标志。取值含义：0：允许操作；1：
表示禁止操作；2：除了禁止用户操作外，还将
禁止任何脚本中向DB设置数据请求。
返回值
备注
示例DisableOperate (1);//禁止操作
DisableOperate (0);//允许操作
Display
语法Display(WinName)
说明显示名字为WinNamede的窗口。
参数
返回值
备注显示名字为WinName的窗口。如果该窗口已经运
行，则该窗口将成为当前活动窗口。
示例Display(“Win01”); //显示窗口Win01。
EventDisp
语法EventDisp()
说明显示系统事件．
系统事件包括程序起停信息，操作记录，系统
错误信息等．
400 第三部分参考手册
参数
返回值
备注
示例EventDisp()//调用该函数将出现一事件显示
框．
Exit
语法Exit(code)
说明code取值为０，１，２，３，４。
参数０表示退出程序。
１表示窗口最小化。
２表示退出所有力控程序。
３表示重新启动系统。
４表示关闭系统。
返回值
备注
示例Exit(0);// 退出应用程序
FileCopy
语法FileCopy(SourFileName,DestFileName ,
Overwrite )
说明文件复制。复制已有文件（由文件名
SourFileName指定）到一新文件（由文件名
DestFileName指定）
参数SourFileName：字符串常量，或字符串表达式，
为源文件名（完整的路径），即已存在文件。
DestFileName：字符串常量，或字符串表达式，
为新文件名（完整的路径）。
Overwrite：整型量，覆盖标志。该量如果为0，
如果同名文件已经存在，那么复制失败；非0
将覆盖已有文件
返回值为1成功；为0失败。
备注
示例FileCopy("c:\",
c:\, 0);
//将c：盘下abc目录下的文件，复

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。