组态王命令语言函数速查手册
北京亚控科技发展有限公司
1
命令语言函数速查手册
“组态王”支持使用内建的复杂函数，其中包括字符串函数、数学函数、
系统函数、控件函数、报表函数及其他函数，下面依次介绍各个函数（函数名
不区分大小写，按字母排序）：
Abs
此函数用于计算变量值的绝对值，使用格式如下：
Abs(变量名或数值);
返回值：整值或实型值；
例如：
Abs(14); 返回值为14
Abs(-7.5); 返回值为7.5
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 个。
当对报表的指定单元格区域内的单元格进行求平均值运算时，结果
显示在当前单元格内，语法格式使用如下：
Average（’a1’,‘a2‘）;
组态王命令语言函数速查手册
北京亚控科技发展有限公司
5
例如：
任意单元格选择求平均值:
=Average（‘a1’,‘b2’,‘r10’）;
连续的单元格求平均值:
=Average(‘b1:b10’);
或求变量的平均值：
AverageValue= Average(lVar1,fVar1);
BackUpHistData
此函数为组态王网络中从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:整型或实型变量
组态王命令语言函数速查手册
北京亚控科技发展有限公司
6
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
此函数显示“更改口令”对话框，允许登录工程人员更改他们的口
令。使用格式：
ChangePassword();
例如：
为画面上某一按钮设置命令语言连接：
组态王命令语言函数速查手册
北京亚控科技发展有限公司
7
ChangePassword( );
运行时单击此按钮，弹出对话框：
提示工程人员输入当前的口令和新口令以及验证新口令。完
全正确后，工程人员的口令设置为新值。
chartAdd
此函数用于在指定的棒图控件中增加一个新的条形图。语法格式如
下：
chartAdd( "ControlName", Value, "label" );
参数：ControlName：工程人员定义的棒图控件名称，可以为中文名
或英文名。
Value：设定条形图的初始值，整形数据, 实型数据。
label：设定条形图的标签值，默认值=索引值Index，Index
的取值范围是1-16。
例如：
chartAdd( "XYChart", 1, "L6" );
此语句将在棒图控件XYChart 中增加一个标签为L6 的条形
图，其初始值为1。
组态王命令语言函数速查手册
北京亚控科技发展有限公司
8
chartClear
此函数用于在指定的棒图控件中清除所有的棒形图。语法格式如下：
chartClear( "ControlName" );
参数：ControlName：工程人员定义的棒图控件名称，可以为中文名
或英文名。
例如：
chartClear( "XYChart" );
此语句把棒图控件XYChart 中的所有棒图清除。
chartSetBarColor
此函数用于在指定的棒图控件中设置饼图的颜。条形图不可以。
语法格式如下：
chartSetBarColor( "ControlName", barIndex,
colorIndex );
参数：
ControlName：工程人员定义的棒图控件名称，可以为中文名或英文
名。
barIndex: 整型变量，表示条形图索引号，用于设定指定的条形
我的草原我的马我想咋耍就咋耍图，其取值范围为0-15。
colorIndex: 整型变量，表示条形图的颜索引号，用于设置指定
条形图的颜，其取值范围为0-15，颜索引号和相应的颜如下
所示。
颜索引号 代表颜 颜索引号 代表颜
0 Default 8 Gray
1 Blue 9 Light Blue
2 Green 10 Light Green
陈柏宇新歌3 Cyan 11 Light Cyan
组态王命令语言函数速查手册
北京亚控科技发展有限公司
9
4 Red 12 Light Red
5 Magenta 13 Light Magenta
6 Yellow 14 Light Yellow
7 White 15 Bright White
16 Black
例如：
chartSetBarColor( "XYChart", 0, 1 );
此语句将棒图控件XYChart 中第一块饼图的颜设为blue
（即兰）。
chartSetBarColor( "XYChart", 2, 4 );
此语句将棒图控件XYChart 中第三块饼图的颜设为red（即