组态王命令语言函数速查手册三.doc

组态王命令语言函数速查手册
北京亚控科技发展
1
命令语言函数速查手册
“组态王”支持使用内建的复杂函数，其中包括字符串函数、数学函数、
系统函数、控件函数、报表函数及其他函数，下面依次介绍各个函数（函数名
不区分大小写，按字母排序）：
Abs
此函数用于计算变量值的绝对值，使用格式如下：
Abs(变量名或数值);
返回值：整值或实型值；
例如：
Abs(14); 返回值为14
Abs(距离); 返回内存模拟变量“距离”的绝对值。
Ack
对变量进行报警确认，或对报警组进行报警确认。如果函数参数为
变量名称，则只对该变量进行报警确认；如果函数参数为报警组名
称，则确认所有属于该报警组及其子报警组的变量。该函数的参数
只能是变量名或报警组名，不可以为字符串变量。此函数常用于按
钮命令语言，当发生报警时，用此函数进行报警确认，它将产生确
认报警事件。调用格式：
Ack(报警组名)； 或 Ack(变量名)；
例如：
Ack(全厂)； 或 Ack(反应罐液位)；
组态王命令语言函数速查手册
北京亚控科技发展
2
AckByTagName
对变量进行报警确认。函数参数可以是一个字符串变量，也可以是
一个表示变量名的字符串。调用格式：
AckByTagName("tag_name");
参数：tag_name：变量名。
例如：
AckByTagName ("\\本站点\液位");
AckByTagName(Varname);其中Varname 为字符串变量。
AckByGroupName
对报警组进行确认。调用格式：
AckByGroupName( "station_name", "group_name" );
station_name 为产生报警的IO 服务器名，group_name 为报警组名。
函数参数可以是字符串变量，也可以是表示IO 服务器名或报警组名
的字符串。
例如：
AckByGroupName ("PC1","报警组1");
AckByGroupName (PCName, GroupName);//PCName, GroupName
为字符串变量。
ActivateApp
此函数用于激活正在运行的窗口应用程序，使之变为当前窗口。获
得输入焦点。该函数也可配合函数SendKeys 的使用。调用形式：
ActivateApp(“ExeName”)；
参数：ExeName 应用程序的执行文件名
例如：
组态王命令语言函数速查手册
北京亚控科技发展
3
激活Microsoft Word 的正确调用为：
ActivateApp("")；
激活组态王：
可使用 ActivateApp("")；
ActiveXIsVisible
此函数用于控制窗体控件隐含。调用形式：
ActiveXIsVisible("CtrlName", nMode)；
参数：CtrlName 控件名
nMode 控制模式。nMode=0 时，控件隐含。
例如：
实现控件隐含的正确调用为：
ActiveXIsVisible(“Ctrl10”, 0)；
ArcCos
此函数用于计算变量值的反余弦值, 变量值的取值范围在[-1，1]
之间，否则函数返回值无效。调用格式：
ArcCos(变量名或数值);
返回值：整值或实型值；
例如：
ArcCos(1); 此函数返回值为0
ArcCos(temp); 此函数返回变量“temp”的反余弦值。
ArcSin
组态王命令语言函数速查手册
北京亚控科技发展
4
此函数用于计算变量值的反正弦值, 变量值的取值范围在[-1，1]
之间，否则函数返回值无效。调用格式：
ArcSin(变量名或数值);
返回值：整值或实型值；
例如：
ArcSin(1); 此函数返回值为90
ArcSin(temp); 此函数返回变量“temp”的反正弦值。
ArcTan
此函数用于计算变量值的反正切值, 使用格式为：
ArcTan(变量名或数值);
返回值：整值或实型值；
例如：
ArcTan(1); 此函数返回值为45
ArcTan (temp); 此函数返回变量“temp”的反正切值。
Average
此函数为对指定的组态王报表表格的多个单元格求平均值，或求多
个变量的平均值。语法格式使用如下：
Average（’a1’,’a2’）; 或Average('a1:a10');
a1、a2……为组态王单元格所在的行号列标，或整型或实型变量。其
中参数个数为1-32 个。
当对报表的指定单元格区域内的单元格进