精心整理组态王常用命令语言函数速查手册

1组态王命令语言函数手册“组态王”支持使用内建的复杂函数，其中包括字符串函数、数学函数、系统函数、控件函数、报表函数及其他函数，下面依次介绍各个函数（函数名不区分大小写，按字母排序）：Abs此函数用于计算变量值的绝对值，使用格式如下：Abs(变量名或数值);返回值：整值或实型值；例如：Abs(14);返回值为14Abs(-7.5);返回值为7.5Abs(距离);返回内存模拟变量“距离”的绝对值。Ack对变量进行报警确认，或对报警组进行报警确认。如果函数参数为变量名称，则只对该变量进行报警确认；如果函数参数为报警组名称，则确认所有属于该报警组及其子报警组的变量。该函数的参数只能是变量名或报警组名，不可以为字符串变量。此函数常用于按钮命令语言，当发生报警时，用此函数进行报警确认，它将产生确认报警事件。调用格式：Ack(报警组名)；或Ack(变量名)；例如：Ack(全厂)；或Ack(反应罐液位)；ActivateAppactivate['æktɪveɪt]vt.刺激；使活动；使活泼；使产生放射性app[æp]n.应用程序此函数用于激活正在运行的窗口应用程序，使之变为当前窗口。获得输入焦点。该函数也可配合函数SendKeys的使用。调用形式：ActivateApp(“ExeName”)；参数：ExeName应用程序的执行文件名例如：激活MicrosoftWord的正确调用为：ActivateApp(Word.exe)；ArcCosarc[ɑːk]adj.圆弧的；反三角函数的此函数用于计算变量值的反余弦值,变量值的取值范围在[-1，1]之间，否则函数返回值无效。调用格式：ArcCos(变量名或数值);返回值：整值或实型值；例如：ArcCos(1);此函数返回值为0ArcCos(temp);此函数返回变量“temp”的反余弦值。Average['æv(ə)rɪdʒ]n.平均；平均数；adj.平均的vt.算出…的平均数；将…平均分配；使…平衡此函数为对指定的组态王报表表格的多个单元格求平均值，或求多个变量的平均值。语法格式使用如下：Average（’a1’,’a2’）;或Average('a1:a10');a1、a2……为组态王单元格所在的行号列标，或整型或实型变量。其中参数个数为1-32个。当对报表的指定单元格区域内的单元格进行求平均值运算时，结果显示在当前单元格内，语法格式使用如下：Average（’a1’,‘a2‘）;例如：任意单元格选择求平均值:=Average（‘a1’,‘b2’,‘r10’）;连续的单元格求平均值:=Average(‘b1:b10’);或求变量的平均值：AverageValue=2Average(lVar1,fVar1);BackUpHistDatahistory[hɪst]hist-历史此函数为组态王网络中从IO服务器上下载历史数据记录到历史记录服务器。用户在历史记录服务器上调用该函数。函数的使用需要与组态王网络配置相配合，具体内容参见《组态王6.53使用手册》中“历史库”一章。语法使用格式：BackupStationData(StrchMchinename,LongftEndtime);参数：chMchinename字符串型为进行备份存储的IO服务器名ftEndtime整型为备份截止时间例如：//备份“IO采集站”的历史数据，截至时间为当前：endTime=HTConvertTime($年,$月,$日,$时,$分,0);BackUpHistData(IO采集站,endTime);Bit此函数用以取得一个整型或实型变量某一位的值(0或1)。用法：OnOff=Bit(Var,bitNo);//OnOff:离散变量参数：Var:整型或实型变量bitNo:位的序号，取值1至16返回值：离散型。若变量Var的第bitNo位为0，返回值OnOff为0；若变量Var的第bitNo位为1，返回值OnOff为1。例如：开关=Bit(DDE1,6);从变量DDE1的第6位得到变量“开关”状态。BitSet此函数将一个整型或实型变量的任一位置为指定值(0或1)。语法格式：BitSet(Var,bitNo,OnOff);参数：Var:整型或实型变量bitNo:位的序号，取值1至16OnOff:位的设定值注意：对于IO变量来说，BitSet函数只是用于可读可写的变量。例如：BitSet(DDE1,6,0);将变量DDE1的第6位置为0。ChangePasswordpassword['pɑːswɜːd]n.密码；口令此函数显示“更改口令”对话框，允许登录工程人员更改他们的口令。使用格式：ChangePassword();例如：为画面上某一按钮设置命令语言连接：ChangePassword();运行时单击此按钮，弹出对话框：3提示工程人员输入当前的口令和新口令以及验证新口令。完全正确后，工程人员的口令设置为新值。ClosePicture此函数用于将已调入内存的画面关闭，并从内存中删除。语法格式如下：ClosePicture(画面名);例如：ClosePicture(反应车间);将关闭画面“反应车间”。ConfigODBC此函数用于配置odbc的数据源，语法格式如下：ConfigODBC(nDatatbasetype,szAttributes);参数：nDatatbasetype：数据库类型，目前支持Access，SQLserver该参数为0时表示数据库类型为Access，参数为1时表示数据库类型为SQLserver；szAttributes：配置字符串:例1：配置Access数据库，DSN名称为demo2，数据库文件为E:\ProgramFiles\Kingview\Example\Kingdemo1\数据库.mdb。ConfigODBC(0,DSN=demo2\0Description=E:\ProgramFiles\Kingview\Example\Kingdemo1\数据库.mdb\0PWD=1234\0UID=shihf);例2：配置SQL数据库：ConfigODBC(1,DSN=MyDSN\0Description=SQLConfigDSNSample\0SERVER=MySQL\0ADDRESS=MyServer\0NETWORK=dbmssocn\0DATABASE=pubs\0);Date此函数为根据给出的年、月、日整型数，返回日期字符串，默认格式为：年：月：日。语法使用格式如下：Date（LONGnYear,LONGnMonth,LONGnDay）;例如：年、月、日变量分别为：“$年”、“$月”、“$日”，用日期来显示由以上三个整数决定的“日期”字符串，则在命令语言中输入：日期=Date（年,月,日）;DisplayMCI4此函数提供了一个对多媒体设备的通用接口，具有强大的功能。语法使用格式：DisplayMCI(MCICommand,option);下面举例说明此函数的使用方法。例如：DisplayMCI(“PLAYCD”,3);用于播放CD唱片中的第3支歌曲。DisplayMCI(“STOPCD”,””);用于停止播放CD。DisplayMCI(“PLAYMIDI”,”c:\midi.mid”);用于播放MIDI格式的背景音乐”c:\midi.mid”。DisplayMCI(“PAUSEMIDI”,”c:\midi.mid”);暂停播放MIDI格式的背景音乐”c:\midi.mid”。DisplayMCI(“RESUMMIDI”,”c:\midi.mid”);继续播放MIDI格式的背景音乐”c:\midi.mid”。DisplayMCI(“CLOSEMIDI”,”c:\midi.mid”);停止播放MIDI格式的背景音乐”c:\midi.mid”。DisplayMCI(“EJECTCD”);将光驱中的CD盘片弹出。Dtext此函数用于按离散变量的值动态地改变字符串变量。语法格式如下：Str=Dtext(Discrete_Tag,OnMsg,OffMsg)；参数描述Discrete_Tag离散变量名。OnMsg字符串变量名OffMsg字符串变量名当Discrete_Tag＝1时，Str的值为OnMsg当Discrete_Tag＝0时，Str的值为OffMsg例如：Str=Dtext(电源开关，电源打开,电源关闭);当电源开关＝1时，Str的值为电源打开当电源开关＝0时，Str的值为电源关闭。EnableAllAlarm全局报警使能函数。调用形式：EnableAllAlarm(is_enable);参数描述：is_enable整数变量或数值0--禁止所有报警非0--使能所有报警返回值：整数型，反映当前全局报警使能的状态：若为非0：使能；为0：禁止EnableNavigate此函数用于显示/关闭导航图。调用形式：EnableNavigate(is_enable);参数：is_enable，整型。0:is_enable为0时，关闭导航图1:is_enable为1时，显示导航图。使用EnableNavigate函数关闭导航图后，除非使用该函数来显示导航图，否则无法显示导航图。例如：EnableNavigate(0);//关闭导航图EnableSaveTagValueToIniValueWhenValueChange对于设置了“保存数值”和“保存参数”的变量，使用该函数后，当变量的值和参数发生5变化时，系统会自动将变量的值和参数保存到文件tagname.db中，无论组态王运行系统是否正常退出，再次运行后，将保存的变量值和变量参数作为变量的初始值和初始参数。“保存数值”和“保存参数”的具体含义请参见《组态王手册》第七章变量定义和管理部分。调用形式：EnableSaveTagValueToIniValueWhenValueChange(is_enable);参数：is_enable：整型变量或数值1：当变量的值和参数发生变化时，保存变量数值和参数。组态王运行系统退出，再次运行后，将保存的变量值和变量参数作为变量的初始值和初始参数。0：与组态王“保存数值”和“保存参数”实现的功能相同。例如：组态王开发系统数据词典中定义变量，设置“保存数值”。执行函数：EnableSaveTagValueToIniValueWhenValueChange(1);该变量的值发生变化时，系统保存该变量的值。组态王运行系统退出，再次运行后，将保存的变量值作为变量的初始值。Exit此函数使组态王运行环境退出。调用形式：Exit(Option);参数：Option:整型变量或数值0-退出当前程序；1-关机；2-重新启动windows；Exp此函数返回指数函数ex的计算结果使用格式如下：Exp(数值或变量名);例如：Exp(1);返回e1的计算值2.718Exp(temp);计算e常量的temp次幂并返回计算结果。GetAlarmNumInGroup此函数用来对某一个报警组当前的报警变量数量进行统计语法格式：longGetAlarmNumInGroup(MachineName,GroupName);参数说明：MachineName：报警组所在的站点名称(对于单机网络，使用时用空字符串代替)GroupName：要获取报警变量个数的报警组名返回值：整型，返回值表示报警变量数量特别说明：对于网络节点，需要把“本机为报警服务器”钩上，才能正确获取到远程节点的报警变量个数。GetBackupProgress此函数用于在组态王进行网络历史数据备份合并时获得进度百分比。使用时需要通过命令语言调用来获得进度值。语法使用格式：GetBackupProgress(strszStationName);参数：szStationName远程站点名称。返回值：整型，为0~100间的进度值。例如：备份进度=GetBackupProgress(“IO采集站”);6GetCursorPosX此函数返回当前鼠标的X坐标。调用格式：result=GetCursorPosX();返回值