组态王命令语言函数速查手册资料下载.pdf

1、返回值为 7.5 Abs（距离）;返回内存模拟变量“距离”的绝对值。Ack 对变量进行报警确认，或对报警组进行报警确认。如果函数参数为 变量名称，则只对该变量进行报警确认；如果函数参数为报警组名 称，则确认所有属于该报警组及其子报警组的变量。该函数的参数 只能是变量名或报警组名，不可以为字符串变量。此函数常用于按 钮命令语言，当发生报警时，用此函数进行报警确认，它将产生确 认报警事件。调用格式：Ack（报警组名）；或 Ack（变量名）；Ack（全厂）；或 Ack（反应罐液位）；组态王命令语言函数速查手册 北京亚控科技发展有限公司 2 AckByTagName 对变量进行报警确认。函数参数可以是

2、一个字符串变量，也可以是 一个表示变量名的字符串。AckByTagName（tag_name）;参数：tag_name：变量名。AckByTagName（本站点液位）;AckByTagName（Varname）;其中 Varname 为字符串变量。AckByGroupName 对报警组进行确认。AckByGroupName（station_name,group_name）;station_name 为产生报警的 IO 服务器名，group_name 为报警组名。函数参数可以是字符串变量，也可以是表示 IO 服务器名或报警组名 的字符串。AckByGroupName（PC1,报警组 1）;Ack

3、ByGroupName（PCName,GroupName）;/PCName,GroupName 为字符串变量。ActivateApp 此函数用于激活正在运行的窗口应用程序，使之变为当前窗口。获 得输入焦点。该函数也可配合函数 SendKeys 的使用。调用形式：ActivateApp（“ExeName”）；ExeName 应用程序的执行文件名 例如：组态王命令语言函数速查手册 北京亚控科技发展有限公司 3 激活 Microsoft Word 的正确调用为：ActivateApp（Word.exe）；激活组态王：可使用 ActivateApp（TouchVew.exe）；ActiveXIsVis

4、ible 此函数用于控制窗体控件隐含。ActiveXIsVisible（CtrlName,nMode）；CtrlName 控件名 nMode 控制模式。nMode=0 时，控件隐含。实现控件隐含的正确调用为：ActiveXIsVisible（“Ctrl10”,0）；ArcCos 此函数用于计算变量值的反余弦值,变量值的取值范围在-1，1 之间，否则函数返回值无效。ArcCos（变量名或数值）;ArcCos（1）;此函数返回值为 0 ArcCos（temp）;此函数返回变量“temp”的反余弦值。ArcSin 组态王命令语言函数速查手册 北京亚控科技发展有限公司 4 此函数用于计算变量值的反正弦

5、值,变量值的取值范围在-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为组态王单元格所在的行号列

6、标，或整型或实型变量。其 中参数个数为 1-32 个。当对报表的指定单元格区域内的单元格进行求平均值运算时，结果 显示在当前单元格内，语法格式使用如下：组态王命令语言函数速查手册 北京亚控科技发展有限公司 5 例如：任意单元格选择求平均值:=Average（a1,b2,r10）;连续的单元格求平均值:=Average（b1:b10）;或求变量的平均值：AverageValue=Average（lVar1,fVar1）;BackUpHistData 此函数为组态王网络中从 IO 服务器上下载历史数据记录到历史记录 服务器。用户在历史记录服务器上调用该函数。函数的使用需要与组 态王网络配置相配合，

7、具体内容参见组态王 6.53 使用手册中“历 史库”一章。语法使用格式：BackupStationData（Str chMchinename,Long ftEndtime）;chMchinename 字符串型 为进行备份存储的 IO 服务器名 ftEndtime 整型 为备份截止时间 例如：/备份“IO 采集站”的历史数据，截至时间为当前：endTime=HTConvertTime（$年,$月,$日,$时,$分,0）;BackUpHistData（IO 采集站,endTime）;Bit 此函数用以取得一个整型或实型变量某一位的值（0 或 1）。用法：OnOff=Bit（Var,bitNo）;/

8、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）;整型或实型变量 bitNo:位的序号，取值 1 至 16 OnOff:位

9、的设定值 注意：对于 IO 变量来说，BitSet 函数只是用于可读可写的变量。BitSet（DDE1,6,0）;将变量 DDE1 的第 6 位置为 0。ChangePassword 此函数显示“更改口令”对话框，允许登录工程人员更改他们的口 令。使用格式：ChangePassword（）;为画面上某一按钮设置命令语言连接：组态王命令语言函数速查手册 北京亚控科技发展有限公司 7 ChangePassword（）;运行时单击此按钮，弹出对话框：提示工程人员输入当前的口令和新口令以及验证新口令。完 全正确后，工程人员的口令设置为新值。chartAdd 此函数用于在指定的棒图控件中增加一个新的条形

10、图。语法格式如 下：chartAdd（ControlName,Value,label）;ControlName：工程人员定义的棒图控件名称，可以为中文名 或英文名。Value：设定条形图的初始值，整形数据,实型数据。label：设定条形图的标签值，默认值=索引值 Index，Index 的取值范围是 1-16。chartAdd（XYChart,1,L6）;此语句将在棒图控件 XYChart 中增加一个标签为 L6 的条形 图，其初始值为 1。组态王命令语言函数速查手册 北京亚控科技发展有限公司 8 chartClear 此函数用于在指定的棒图控件中清除所有的棒形图。语法格式如下：chartCl

11、ear（ControlName）;chartClear（XYChart）;此语句把棒图控件 XYChart 中的所有棒图清除。chartSetBarColor 此函数用于在指定的棒图控件中设置饼图的颜色。条形图不可以。chartSetBarColor（ControlName,barIndex,colorIndex）;工程人员定义的棒图控件名称，可以为中文名或英文 名。barIndex:整型变量，表示条形图索引号，用于设定指定的条形 图，其取值范围为 0-15。colorIndex:整型变量，表示条形图的颜色索引号，用于设置指定 条形图的颜色，其取值范围为 0-15，颜色索引号和相应的颜色如下

12、所示。颜色索引号 代表颜色 颜色索引号 代表颜色 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 中第一块饼图的颜色设为

13、 blue（即兰色）。chartSetBarColor（XYChart,2,4）;此语句将棒图控件 XYChart 中第三块饼图的颜色设为 red（即 红色）。chartSetValue 此函数用于在指定的棒图控件中设定/修改索引值为 Index 的条形 图的数据。chartSetValue（ControlName,Index,Value）;设定条形图的数据，整形数据,实型数据。Index：条形图的标签值，Index 的取值范围是 0-15，组态王自动 从 0 开始加 1，给每一个新增加的条形图由小到大设定标签值。chartSetValue（XYChart,2,30）;此语句将在棒图控件 XY

14、Chart 中设定索引值为 2（第三条）的条形图的数据为 30。组态王命令语言函数速查手册 北京亚控科技发展有限公司 10 ClosePicture 此函数用于将已调入内存的画面关闭，并从内存中删除。语法格式 如下：ClosePicture（画面名）;ClosePicture（反应车间）;将关闭画面“反应车间”。ConfigODBC 此函数用于配置 odbc 的数据源，语法格式如下：ConfigODBC（nDatatbasetype,szAttributes）;nDatatbasetype：数据库类型，目前支持 Access，SQL server 该参数为 0 时表示数据库类型为 Access

15、，参数为 1 时表示数据库类 型为 SQL server；szAttributes：配置字符串:例 1：配置 Access 数据库，DSN 名称为 demo2，数据库文件为 E:Program FilesKingviewExampleKingdemo1数据库.mdb。ConfigODBC（0,DSN=demo20Description=E:Program FilesKingviewExampleKingdemo1数据 库.mdb0PWD=12340UID=shihf）;例 2：配置 SQL 数据库：ConfigODBC（1,DSN=MyDSN0 Description=SQLConfigDSN

16、 组态王命令语言函数速查手册 北京亚控科技发展有限公司 11 Sample0SERVER=MySQL0ADDRESS=MyServer0NETWORK=dbmssoc n0DATABASE=pubs0）;Cos 此函数用于计算变量值的余弦值,语法格式如下：Cos（数值或变量名）;Cos（90）;返回值为 0 Cos（temp）;返回变量“temp”的余弦值。Date 此函数为根据给出的年、月、日整型数，返回日期字符串，默认格 式为：年：月：日。语法使用格式如下：Date（LONG nYear,LONG nMonth,LONG nDay）;年、月、日变量分别为：“$年”、“$月”、“$日”，用日期来显 示由以上三个整数决定的“日期”字符串，则在命令语言中输入：日期=Date（年,月,日）;DisplayMCI 此函数提供了一个对多媒体设备的通用接口，具有强大的功能。语 法使用格式：DisplayMCI（MCICommand