组态王version - 6.53命令语言函数速查手册

工业自动化通用组态软件 组态王version6.53 命令语言函数速查手册

“组态王”支持使用内建的复杂函数，其中包括字符串函数、数学函数、系统函数、控件函数、报表函数及其他函数，下面依次介绍各个函数（函数名不区分大小写，按字母排序）：

Abs

此函数用于计算变量值的绝对值，使用格式如下： Abs(变量名或数值); 返回值：整值或实型值； 例如：

Abs(14);返回值为14 Abs(-7.5);返回值为7.5

Abs(距离);返回内存模拟变量“距离”的绝对值。

Ack

对变量进行报警确认，或对报警组进行报警确认。如果函数参数为变量名称，则只对该变量进行报警确认；如果函数参数为报警组名称，则确认所有属于该报警组及其子报警组的变量。该函数的参数只能是变量名或报警组名，不可以为字符串变量。此函数常用于按钮命令语言，当发生报警时，用此函数进行报警确认，它将产生确认报警事件。调用格式： Ack(报警组名)；或Ack(变量名)； 例如：

Ack(全厂)；或Ack(反应罐液位)；

AckByTagName

对变量进行报警确认。函数参数可以是一个字符串变量，也可以是一个表示变量名的字符串。调用格式：

AckByTagName(\参数：tag_name：变量名。 例如：

AckByTagName(\本站点\\液位\

AckByTagName(Varname);其中Varname为字符串变量。

AckByGroupName

对报警组进行确认。调用格式：

AckByGroupName(\

station_name为产生报警的IO服务器名，group_name为报警组名。

函数参数可以是字符串变量，也可以是表示IO服务器名或报警组名的字符串。 例如：

AckByGroupName(\报警组1\

AckByGroupName(PCName,GroupName);//PCName,GroupName为字符串变量。

ActivateApp

此函数用于激活正在运行的窗口应用程序，使之变为当前窗口。获得输入焦点。该函数也可配合函数SendKeys的使用。调用形式： ActivateApp(“ExeName”)；

参数：ExeName应用程序的执行文件名 例如：

激活MicrosoftWord的正确调用为：

ActivateApp(\； 激活组态王：

可使用ActivateApp(\；

ActiveXIsVisible

此函数用于控制窗体控件隐含。调用形式： ActiveXIsVisible(\； 参数：CtrlName控件名

nMode控制模式。nMode=0时，控件隐含。 例如：

实现控件隐含的正确调用为：

ActiveXIsVisible(“Ctrl10”,0)；

ArcCos

此函数用于计算变量值的反余弦值,变量值的取值范围在[-1，1]之间，否则函数返回值无效。调用格式：

ArcCos(变量名或数值); 返回值：整值或实型值； 例如：

ArcCos(1);此函数返回值为0

ArcCos(temp);此函数返回变量“temp”的反余弦值。

ArcSin

此函数用于计算变量值的反正弦值,变量值的取值范围在[-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‘）; 例如：

任意单元格选择求平均值:

=Average（‘a1’,‘b2’,‘r10’）; 连续的单元格求平均值: =Average(‘b1:b10’); 或求变量的平均值：

AverageValue=Average(lVar1,fVar1);

BackUpHistData

此函数为组态王网络中从IO服务器上下载历史数据记录到历史记录服务器。用户在历史记录服务器上调用该函数。函数的使用需要与组态王网络配置相配合，具体内容参见《组态王6.53使用手册》中“历史库”一章。 语法使用格式：

BackupStationData(StrchMchinename,LongftEndtime);

参数：chMchinename字符串型为进行备份存储的IO服务器名ftEndtime整型为备份截止时间 例如：

//备份“IO采集站”的历史数据，截至时间为当前： endTime=HTConvertTime($年,$月,$日,$时,$分,0); BackUpHistData(\采集站\

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

此函数显示“更改口令”对话框，允许登录工程人员更改他们的口令。使用格式： ChangePassword(); 例如：

为画面上某一按钮设置命令语言连接： ChangePassword();

运行时单击此按钮，弹出对话框：

提示工程人员输入当前的口令和新口令以及验证新口令。完全正确后，工程人员的口令设置为新值。

chartAdd

此函数用于在指定的棒图控件中增加一个新的条形图。语法格式如下： chartAdd(\

参数：ControlName：工程人员定义的棒图控件名称，可以为中文名或英文名。 Value：设定条形图的初始值，整形数据,实型数据。

label：设定条形图的标签值，默认值=索引值Index，Index的取值范围是1-16。 例如：

chartAdd(\

此语句将在棒图控件XYChart中增加一个标签为L6的条形图，其初始值为1。

chartClear

此函数用于在指定的棒图控件中清除所有的棒形图。语法格式如下： chartClear(\

参数：ControlName：工程人员定义的棒图控件名称，可以为中文名或英文名。 例如：

chartClear(\

此语句把棒图控件XYChart中的所有棒图清除。

chartSetBarColor

此函数用于在指定的棒图控件中设置饼图的颜色。条形图不可以。语法格式如下： chartSetBarColor(\参数：

ControlName：工程人员定义的棒图控件名称，可以为中文名或英文名。

barIndex:整型变量，表示条形图索引号，用于设定指定的条形图，其取值范围为0-15。 colorIndex:整型变量，表示条形图的颜色索引号，用于设置指定条形图的颜色，其取值范围为0-15，颜色索引号和相应的颜色如下所示。颜色索引号代表颜色颜色索引号代表颜色 0Default 8Gray

1Blue 9LightBlue 2Green 10LightGreen 3Cyan 11LightCyan 4Red 12LightRed 5Magenta 13LightMagenta 6Yellow 14LightYellow 7White 15BrightWhite 16Black 例如：

chartSetBarColor(\

此语句将棒图控件XYChart中第一块饼图的颜色设为blue（即兰色）。 chartSetBarColor(\

此语句将棒图控件XYChart中第三块饼图的颜色设为red（即红色）。

chartSetValue

此函数用于在指定的棒图控件中设定/修改索引值为Index的条形图的数据。语法格式如下： chartSetValue(\参数：

ControlName：工程人员定义的棒图控件名称，可以为中文名或英文名。 Value：设定条形图的数据，整形数据,实型数据。

Index：条形图的标签值，，Index的取值范围是0-15，组态王自动从0开始加1，给每一个新增加的条形图由小到大设定标签值。 例如：

chartSetValue(\

此语句将在棒图控件XYChart中设定索引值为2（第三条）的条形图的数据为30。

ClosePicture

此函数用于将已调入内存的画面关闭，并从内存中删除。语法格式如下： ClosePicture(\画面名\例如：

ClosePicture(\反应车间\将关闭画面“反应车间”。

ConfigODBC

此函数用于配置odbc的数据源，语法格式如下： ConfigODBC(nDatatbasetype,szAttributes); 参数：

nDatatbasetype：数据库类型，目前支持Access，SQLserver该参数为0时表示数据库类型为Access，参数为1时表示数据库类型为SQLserver； szAttributes：配置字符串: 例1：

配置Access数据库，DSN名称为demo2，数据库文件为

E:\\ProgramFiles\\Kingview\\Example\\Kingdemo1\\数据库.mdb。 ConfigODBC(0,\Files\\Kingview\\Example\\Kingdemo1\\数据 库.mdb\\0PWD=1234\\0UID=shihf\例2：

配置SQL数据库：

ConfigODBC(1,\

Sample\\0SERVER=MySQL\\0ADDRESS=MyServer\\0NETWORK=dbmssoc n\\0DATABASE=pubs\\0\

Cos

此函数用于计算变量值的余弦值,语法格式如下： Cos(数值或变量名); 例如：

Cos(90);返回值为0

Cos(temp);返回变量“temp”的余弦值。

Date

此函数为根据给出的年、月、日整型数，返回日期字符串，默认格式为：年：月：日。语法使用格式如下：

Date（LONGnYear,LONGnMonth,LONGnDay）; 例如：年、月、日变量分别为：“$年”、“$月”、“$日”，用日期来显示由以上三个整数决定的“日期”字符串，则在命令语言中输入： 日期=Date（年,月,日）;

DisplayMCI

此函数提供了一个对多媒体设备的通用接口，具有强大的功能。语法使用格式： DisplayMCI(\

本文来源：https://www.bwwdw.com/article/d2lt.html