《精心整理组态王常用命令语言函数速查手册》由会员分享，可在线阅读，更多相关《精心整理组态王常用命令语言函数速查手册（27页珍藏版）》请在金锄头文库上搜索。
1、1组态王命令语言函数手册“组态王”支持使用内建的复杂函数，其中包括字符串函数、数学函数、系统函数、控件函数、报表函数及其他函数，下面依次介绍各个函数（函数名不区分大小写，按字母排序）：Abs 此函数用于计算变量值的绝对值，使用格式如下： Abs(变量名或数值); 返回值：整值或实型值； 例如： Abs(14); 返回值为14 Abs(-7.5); 返回值为7.5 Abs(距离); 返回内存模拟变量“距离”的绝对值。Ack 对变量进行报警确认，或对报警组进行报警确认。如果函数参数为变量名称，则只对该变量进行报警确认；如果函数参数为报警组名称，则确认所有属于该报警组及其子报警组的变量。该函数的参数
2、只能是变量名或报警组名，不可以为字符串变量。此函数常用于按钮命令语言，当发生报警时，用此函数进行报警确认，它将产生确认报警事件。调用格式： Ack(报警组名)； 或 Ack(变量名)； 例如： Ack(全厂)； 或 Ack(反应罐液位)； ActivateApp activatektvet vt. 刺激；使活动；使活泼；使产生放射性 app pn.应用程序 此函数用于激活正在运行的窗口应用程序，使之变为当前窗口。获得输入焦点。该函数也可配合函数SendKeys的使用。调用形式： ActivateApp(“ExeName”)； 参数：ExeName 应用程序的执行文件名例如：激活Microsof
3、t Word的正确调用为： ActivateApp(Word.exe)；ArcCos arck adj. 圆弧的；反三角函数的此函数用于计算变量值的反余弦值, 变量值的取值范围在-1，1之间，否则函数返回值无效。调用格式： ArcCos(变量名或数值); 返回值：整值或实型值； 例如： ArcCos(1); 此函数返回值为 0 ArcCos(temp); 此函数返回变量“temp” 的反余弦值。Average v()rd n. 平均；平均数；adj. 平均的 vt. 算出的平均数；将平均分配；使平衡此函数为对指定的组态王报表表格的多个单元格求平均值，或求多个变量的平均值。语法格式使用如下： A
4、verage（a1 ,a2）; 或Average(a1:a10); a1、a2为组态王单元格所在的行号列标，或整型或实型变量。其中参数个数为1-32个。 当对报表的指定单元格区域内的单元格进行求平均值运算时，结果显示在当前单元格内，语法格式使用如下： Average（a1 ,a2）;例如： 任意单元格选择求平均值: =Average（a1 ,b2,r10）; 连续的单元格求平均值: =Average(b1:b10); 或求变量的平均值： AverageValue= 2Average(lVar1,fVar1);BackUpHistData historyhst hist - 历史此函数为组态王网
5、络中从IO服务器上下载历史数据记录到历史记录服务器。用户在历史记录服务器上调用该函数。函数的使用需要与组态王网络配置相配合，具体内容参见组态王6.53使用手册中“历史库”一章。 语法使用格式： BackupStationData (Str chMchinename, Long ftEndtime); 参数：chMchinename 字符串型 为进行备份存储的IO服务器名 ftEndtime 整型 为备份截止时间例如： /备份“IO采集站” 的历史数据，截至时间为当前： endTime=HTConvertTime($年,$月,$日,$时,$分,0); BackUpHistData(IO采集站,
6、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:整型
7、或实型变量 bitNo:位的序号，取值1至16 OnOff:位的设定值 注意：对于IO变量来说，BitSet函数只是用于可读可写的变量。 例如： BitSet(DDE1,6,0); 将变量DDE1的第6位置为0。ChangePassword password pswd n. 密码；口令此函数显示“更改口令” 对话框，允许登录工程人员更改他们的口令。使用格式： ChangePassword(); 例如： 为画面上某一按钮设置命令语言连接：ChangePassword( );运行时单击此按钮，弹出对话框：3提示工程人员输入当前的口令和新口令以及验证新口令。完全正确后，工程人员的口令设置为新值。Cl
8、osePicture 此函数用于将已调入内存的画面关闭，并从内存中删除。语法格式如下： ClosePicture(画面名); 例如： ClosePicture(反应车间); 将关闭画面“反应车间”。ConfigODBC 此函数用于配置odbc的数据源，语法格式如下： ConfigODBC(nDatatbasetype,szAttributes); 参数： nDatatbasetype：数据库类型，目前支持 Access，SQL server 该参数为0时表示数据库类型为Access，参数为1时表示数据库类 型为SQL server ；szAttributes：配置字符串: 例1： 配置 Acc
9、ess数据库，DSN名称为demo2，数据库文件为E:ProgramFilesKingviewExampleKingdemo1数据库.mdb。ConfigODBC(0,DSN=demo20Description=E:Program FilesKingviewExampleKingdemo1数据库.mdb0PWD=12340UID=shihf); 例2： 配置SQL数据库： ConfigODBC(1, DSN=MyDSN0 Description =SQLConfigDSNSample0SERVER=MySQL0ADDRESS=MyServer0NETWORK=dbmssocn0DATABASE
10、=pubs0);Date 此函数为根据给出的年、月、日整型数，返回日期字符串，默认格式为：年：月：日。语法使用格式如下： Date（LONG nYear, LONG nMonth, LONG nDay）; 例如：年、月、日变量分别为：“$年”、“ $月”、“$日”，用日期来显示由以上三个整数决定的“日期” 字符串，则在命令语言中输入： 日期=Date（年,月,日）;DisplayMCI 4此函数提供了一个对多媒体设备的通用接口，具有强大的功能。语法使用格式： DisplayMCI( MCICommand, option ); 下面举例说明此函数的使用方法。 例如： DisplayMCI(“PL
11、AYCD”,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”)
12、; 停止播放MIDI格式的背景音乐”c:midi.mid”。 DisplayMCI(“EJECTCD”); 将光驱中的CD盘片弹出。Dtext 此函数用于按离散变量的值动态地改变字符串变量。语法格式如下： Str = Dtext(Discrete_Tag, OnMsg, OffMsg)； 参数 描述 Discrete_Tag 离散变量名。 OnMsg 字符串变量名 OffMsg 字符串变量名 当Discrete_Tag1时，Str的值为OnMsg 当Discrete_Tag0时，Str的值为OffMsg 例如： Str = Dtext(电源开关，电源打开,电源关闭); 当电源开关1时，Str的
13、值为电源打开当电源开关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时，显示导航图。使用EnableNaviga
14、te函数关闭导航图后，除非使用该函数来显示导航图，否则无法显示导航图。例如： EnableNavigate(0); /关闭导航图EnableSaveTagValueToIniValueWhenValueChange 5对于设置了“保存数值” 和“ 保存参数 ”的变量，使用该函数后，当变量的值和参数发生变化时，系统会自动将变量的值和参数保存到文件tagname.db中，无论组态王运行系统是否正常退出，再次运行后，将保存的变量值和变量参数作为变量的初始值和初始参数。“保存数值” 和“ 保存参数 ”的具体含义请参见组态王手册第七章 变量定义和管理 部分。 调用形式： EnableSaveTagVal
15、ueToIniValueWhenValueChange(is_enable); 参数： is_enable：整型变量或数值1：当变量的值和参数发生变化时，保存变量数值和参数。组态王运行系统退出，再次运行后，将保存的变量值和变量参数作为变量的初始值和初始参数。 0：与组态王“保存数值” 和“ 保存参数 ”实现的功能相同。 例如： 组态王开发系统数据词典中定义变量，设置“保存数值”。执行函数： EnableSaveTagValueToIniValueWhenValueChange(1); 该变量的值发生变化时，系统保存该变量的值。组态王运行系统退出，再次运行后，将保存的变量值作为变量的初始值。Exit 此函数使组态王运行环境退出。调用形式： Exit(Option); 参数： Option: 整型变量或数值 0-退出当前程序； 1-关机； 2-重新启动windows；Exp 此函数返回指数函数ex的计算结果使用格式如下： Exp(数值或变量名); 例如： Exp(1); 返回e1的计算值2.718 Exp(temp); 计算e常量的temp次幂并返回计算结果。GetAlarmNumInGroup 此函数用来对某一个报警组当前的报警变量数量进行统计 语法格式： long GetAlarmNumInGroup(MachineName, GroupName); 参数说明： MachineN
