组态王命令语言函数手册
“组态王”支持使用内建的复杂函数,其中包括字符串函数、数学函数、系统函数、控件函数、报表函数及其他函数,下面依次介绍各个函数(函数名不区分大小写,按字母排序):
Abs
此函数用于计算变量值的绝对值,使用格式如下: Abs(变量名或数值); 返回值:整值或实型值; 例如: Abs(14); 返回值为14 Abs(-7.5); 返回值为7.5
Abs(距离); 返回内存模拟变量“距离”的绝对值。
Ack
对变量进行报警确认,或对报警组进行报警确认。如果函数参数为变量名称,则只对该变量进行报警确认;如果函数参数为报警组名称,则确认所有属于该报警组及其子报警组的变量。该函数的参数只能是变量名或报警组名,不可以为字符串变量。此函数常用于按钮命令语言,当发生报警时,用此函数进行报警确认,它将产生确认报警事件。调用格式: Ack(报警组名); 或 Ack(变量名);
例如: Ack(全厂); 或 Ack(反应罐液位);
ActivateApp activate['æktɪveɪt] vt. 刺激;使活动;使活泼;使产生放射性app [æp]n.应用程序
此函数用于激活正在运行的窗口应用程序,使之变为当前窗口。获得输入焦点。该函数也可配合函数SendKeys的使用。
调用形式: ActivateApp(“ExeName”);
参数:ExeName 应用程序的执行文件名
例如:激活Microsoft Word的正确调用为: ActivateApp("");
ArcCos arc[ɑːk] adj. 圆弧的;反三角函数的
此函数用于计算变量值的反余弦值, 变量值的取值范围在[-1,1]之间,否则函数返回值无效。调用格式: ArcCos(变量名或数值); 返回值:整值或实型值;
例如: ArcCos(1); 此函数返回值为0 ArcCos(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= Average(lVar1,fVar1);
BackUpHistData history[hɪst] hist - 历史
此函数为组态王网络中从IO服务器上下载历史数据记录到历史记录服务器。用户在历史记录服务器上调用该函数。函数的使用需要与组态王网络配置相配合,具体内容参见《组态王6.53使用手册》中“历史库”一章。
语法使用格式: BackupStationData (Str chMchinename, Long ftEndtime);
参数: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至16 OnOff:位的设定值
注意:对于IO变量来说,BitSet函数只是用于可读可写的变量。
例如: BitSet(DDE1,6,0); 将变量DDE1的第6位置为0。
ChangePassword password ['pɑːswɜːd] n. 密码;口令
此函数显示“更改口令”对话框,允许登录工程人员更改他们的口令。使用格式:
ChangePassword(); 例如: 为画面上某一按钮设置命令语言连接:ChangePassword( );
运行时单击此按钮,弹出对话框:
提示工程人员输入当前的口令和新口令以及验证新口令。完全正确后,工程人员的口令设置为新值。
ClosePicture
此函数用于将已调入内存的画面关闭,并从内存中删除。语法格式如下:
ClosePicture("画面名"); 例如: ClosePicture("反应车间"); 将关闭画面“反应车间”。
ConfigODBC
此函数用于配置odbc的数据源,语法格式如下: ConfigODBC(nDatatbasetype,szAttributes);
参数: nDatatbasetype:数据库类型,目前支持 Access,SQL server 该参数为0时表示数据库类型为Access,参数为1时表示数据库类 型为SQL server ;szAttributes:配置字符串:
例1: 配置 Access数据库,DSN名称为demo2,数据库文件为
E:\ProgramFiles\Kingview\Example\Kingdemo1\数据库.mdb。
ConfigODBC(0,"DSN=demo2\0Description=E:\Program Files\Kingview\Example\Kingdemo1\数据库.mdb\0PWD=1234\0UID=shihf");
例2: 配置SQL数据库: ConfigODBC(1, "DSN=MyDSN\0 Description =SQLConfigDSN
Sample\0SERVER=MySQL\0ADDRESS=MyServer\0NETWORK=dbmssocn\0DATABASE=pubs\0");
Date
此函数为根据给出的年、月、日整型数,返回日期字符串,默认格式为:年:月:日。语法使用格式如下:
Date(LONG nYear, LONG nMonth, LONG nDay);
例如:年、月、日变量分别为:“$年”、“$月”、“$日”,用日期来显示由以上三个整数决定的“日期”字符串,则在命令语言中输入: 日期=Date(年,月,日);
DisplayMCI
此函数提供了一个对多媒体设备的通用接口,具有强大的功能。语法使用格式:
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
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论