组态王命令语言函数速查手册 1
命令语言函数速查手册
“组态王”支持使用内建的复杂函数，其中包括字符串函数、数学函数、系统函数、控件函数及其他函数，下面依次介绍各个函数（函数名不区分大小写，按字母排序）：
Ａｂｓ
此函数用于计算变量值的绝对值，使用格式如下：
Ａｂｓ（数值或变量名）； 返回值：整值或实型值； 例如：
Ａｂｓ（１４）； 返回值为１４ Ａｂｓ（－７．５）； 返回值为７．５
Ａｂｓ（距离）； 返回内存模拟变量“距离”的绝对值。
Ａｃｋ
此函数常和按钮连接，当发生报警时，用此函数进行报警确认，它将产生确认报警事件。调用格式：
Ａｃｋ（报警组名）； 或 Ａｃｋ（变量名）； 例如：
Ａｃｋ（全厂）； 或 Ａｃｋ（反应罐液位）；
ＡｃｔｉｖａｔｅＡｐｐ
此函数用于激活正在运行的窗口应用程序，使之获得输入焦点。该函数主要用于配合函数ＳｅｎｄＫｅｙｓ的使用。调用形式：
ＡｃｔｉｖａｔｅＡｐｐ（ＡｐｐＮａｍｅ）；
参数 描述 ＡｐｐＮａｍｅ 应用程序的执行文件名 例如：
激活Ｍｉｃｒｏｓｏｆｔ Ｗｏｒｄ的正确调用为： ＡｃｔｉｖａｔｅＡｐｐ（＂Ｗｏｒｄ．ｅｘｅ＂）；
北京亚控自动化软件科技有限公司
2 组态王命令语言函数速查手册
& 激活组态王： 可使用ActivateApp(\；
ＡｒｃＣｏｓ
此函数用于计算变量值的反余弦值， 变量值的取值范围在［－１，１］之间，否则函数返回值无效。调用格式：
ＡｒｃＣｏｓ（变量名）； 返回值：整值或实型值； 例如：
ＡｒｃＣｏｓ（１）； 此函数返回值为０
ＡｒｃＣｏｓ（ｔｅｍｐ）； 此函数返回变量“ｔｅｍｐ”的反余弦值
ＡｒｃＳｉｎ
此函数用于计算变量值的反正弦值， 变量值的取值范围在［－１，１］之间，否则函数返回值无效。调用格式：
ＡｒｃＳｉｎ（变量值）； 返回值：整值或实型值； 例如：
ＡｒｃＳｉｎ（１）； 此函数返回值为９０
ＡｒｃＳｉｎ（ｔｅｍｐ）； 此函数返回变量“ｔｅｍｐ”的反正弦值
ＡｒｃＴａｎ
此函数用于计算变量值的反正切值， 使用格式为：
ＡｒｃＴａｎ（变量值）； 返回值：整值或实型值； 例如：
ＡｒｃＴａｎ（１）； 此函数返回值为４５
ＡｒｃＴａｎ （ｔｅｍｐ）； 此函数返回变量“ｔｅｍｐ”的反正切值
Ｂｉｔ
此函数用以取得一个整型或实型变量某一位的值（０或１）。用法：
北京亚控自动化软件科技有限公司
组态王命令语言函数速查手册 3
ＯｎＯｆｆ＝Ｂｉｔ（ Ｖａｒ ， ｂｉｔＮｏ） ＯｎＯｆｆ：离散变量 Ｖａｒ：整型或实型变量
ｂｉｔＮｏ：位的序号，取值１至１６
返回值：若变量Ｖａｒ的第ｂｉｔＮｏ位为０，返回值ＯｎＯｆｆ为０； 若变量Ｖａｒ的第ｂｉｔＮｏ位为１，返回值ＯｎＯｆｆ为１； 例如：
开关＝Ｂｉｔ（ＤＤＥ１，６）； 从变量ＤＤＥ１的第６位得到变量“开关”状态。
ＢｉｔＳｅｔ
此函数将一个整型或实型变量的任一位置为指定值（０或１）。用法：
ＢｉｔＳｅｔ（ Ｖａｒ， ｂｉｔＮｏ， ＯｎＯｆｆ） Ｖａｒ：整型或实型变量
ｂｉｔＮｏ：位的序号，取值１至１６ ＯｎＯｆｆ：位的设定值 例如如：
ＢｉｔＳｅｔ（ＤＤＥ１，６，０）； 将变量ＤＤＥ１的第６位置为０。
ＣｈａｎｇｅＰａｓｓｗｏｒｄ
此函数显示“更改口令”对话框，允许登录工程人员更改他们的口令。使用格式：
ＣｈａｎｇｅＰａｓｓｗｏｒｄ（）； 例如：
为画面上某一按钮设置命令语言连接： ＣｈａｎｇｅＰａｓｓｗｏｒｄ（ ）；
运行时单击此按钮，弹出对话框：
北京亚控自动化软件科技有限公司
4 组态王命令语言函数速查手册
提示工程人员输入当前的口令和新口令以及验证新口令。完全正确后，工程人员的口令设置为新值。
ｃｈａｒｔＡｄｄ（）
此函数用于在指定的棒图控件中增加一个新的条形图。 语法格式使用如下：
ｃｈａｒｔＡｄｄ（ ＂ＣｏｎｔｒｏｌＮａｍｅ＂， Ｖａｌｕｅ， ＂ｌａｂｅｌ＂ ）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的棒图控件名称，可以为中文名或英文名。
Ｖａｌｕｅ：设定条形图的初始值，整形数据， 实型数据。
ｌａｂｅｌ：设定条形图的标签值，默认值＝索引值Ｉｎｄｅｘ，Ｉｎｄｅｘ的取值范围是１－１６。 例如：
ｃｈａｒｔＡｄｄ（ ＂ＸＹＣｈａｒｔ＂， １， ＂Ｌ６＂ ）；
此语句将在棒图控件ＸＹＣｈａｒｔ中增加一个标签为Ｌ６的条形图，其初始值为１。
ｃｈａｒｔＣｌｅａｒ（）
此函数用于在指定的棒图控件中清除所有的棒形图。 语法格式使用如下：
ｃｈａｒｔＣｌｅａｒ（ ＂ＣｏｎｔｒｏｌＮａｍｅ＂ ）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的棒图控件名称，可以为中文名或英文名。
北京亚控自动化软件科技有限公司
组态王命令语言函数速查手册 5
例如：
ｃｈａｒｔＣｌｅａｒ（ ＂ＸＹＣｈａｒｔ＂ ）；
此语句把棒图控件ＸＹＣｈａｒｔ中的所有棒图清除。
ｃｈａｒｔＳｅｔＢａｒＣｏｌｏｒ（）
此函数用于在指定的棒图控件中设置饼图的颜色。条形图不可以。 语法格式使用如下：
ｃｈａｒｔＳｅｔＢａｒＣｏｌｏｒ（ ＂ＣｏｎｔｒｏｌＮａｍｅ＂， ｂａｒＩｎｄｅｘ， ｃｏｌｏｒＩｎｄｅｘ ）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的棒图控件名称，可以为中文名或英文名。
ｂａｒＩｎｄｅｘ： 整型变量，表示条形图索引号，用于设定指定的条形图，其取值范围为１－１６。
ｃｏｌｏｒＩｎｄｅｘ： 整型变量，表示条形图的颜色索引号，用于设置指定条形图的颜色，其取值范围为１－１６，颜色索引号和相应的颜色如下所示。
颜色索引号 代表颜色 颜色索引号 代表颜色 ０ Ｄｅｆａｕｌｔ ８ Ｇｒａｙ １ Ｂｌｕｅ ９ Ｌｉｇｈｔ Ｂｌｕｅ ２ Ｇｒｅｅｎ １０ Ｌｉｇｈｔ Ｇｒｅｅｎ ３ Ｃｙａｎ １１ Ｌｉｇｈｔ Ｃｙａｎ ４ Ｒｅｄ １２ Ｌｉｇｈｔ Ｒｅｄ ５ Ｍａｇｅｎｔａ １３ Ｌｉｇｈｔ Ｍａｇｅｎｔａ ６ Ｙｅｌｌｏｗ １４ Ｌｉｇｈｔ Ｙｅｌｌｏｗ ７ Ｗｈｉｔｅ １５ Ｂｒｉｇｈｔ Ｗｈｉｔｅ １６ Ｂｌａｃｋ 例如：
ｃｈａｒｔＳｅｔＢａｒＣｏｌｏｒ（ ＂ＸＹＣｈａｒｔ＂， ０， １ ）；
此语句将棒图控件ＸＹＣｈａｒｔ中第一块饼图的颜色设为ｂｌｕｅ（即兰色）。
ｃｈａｒｔＳｅｔＢａｒＣｏｌｏｒ（ ＂ＸＹＣｈａｒｔ＂， ２， ４ ）；
此语句将棒图控件ＸＹＣｈａｒｔ中第三块饼图的颜色设为ｒｅｄ（即
北京亚控自动化软件科技有限公司