组态王命令语言函数手册
组态王支持使用内建的复杂函数,其中包括字符串函数、数学函数、系统函数、控件函数、报表函数及其他函数,下面依次介绍各个函数(函数名不区分大小写,按字母排序):
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. 圆弧的;反三角函数的
此函数用于计算变量值的反余弦值, 变量值的取值范围在[-11]之间,否则函数返回值无效。调用格式: ArcCos(变量名或数值); 返回值:整值或实型值;
例如: ArcCos(1); 此函数返回值为0 ArcCos(temp); 此函数返回变量“temp”的反余弦值。
Average ['æv(ə)rɪdʒ] n. 平均;平均数;adj. 平均的vt. 算出…的平均数;将…平均分配;使…平衡
此函数为对指定的组态王报表表格的多个单元格求平均值,或求多个变量的平均值。语法格式使用如下: Average’a1’,’a2’; Average('a1:a10'); a1a2……为组态王单元格所在的行号列标,或整型或实型变量。其中参数个数为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
此函数用以取得一个整型或实型变量某一位的值(01)。用法:
OnOff=Bit( Var , bitNo); //OnOff:离散变量 参数:Var:整型或实型变量
bitNo:位的序号,取值116 返回值:离散型。若变量Var的第bitNo位为0,返回值OnOff0 若变量Var的第bitNo位为1,返回值OnOff1
例如: 开关=Bit(DDE1,6); 从变量DDE1的第6位得到变量开关状态。
BitSet
此函数将一个整型或实型变量的任一位置为指定值(01)。语法格式:
BitSet( Var, bitNo, OnOff); 参数:Var:整型或实型变量
bitNo:位的序号,取值116 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:数据库类型,目前支持 AccessSQL 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
此函数为根据给出的年、月、日整型数,返回日期字符串,默认格式为:年:月:日。语法使用格式如下:
DateLONG 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_Tag1时,Str的值为OnMsg Discrete_Tag0时,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_enable0时,关闭导航图1:is_enable1时,显示导航图。
使用EnableNavigate函数关闭导航图后,除非使用该函数来显示导航图,否则无法显示导航图。例如: EnableNavigate(0); //关闭导航图
EnableSaveTagValueToIniValueWhenValueChange

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