组态王常用地函数(新颖).doc

word1.ReportSetHistData2 此函数为报表专用函数查询历史数据，系统会自动弹出历史数据查询对话框语法使用格式如下： ReportSetHistData2(StartRow,StartCol); 参数说明： StartRow：查询的数据在报表中填充的起始行数 StartCol：查询的数据在报表中填充的起始列数2.Ack 此函数常和按钮连接，当发生报警时，用此函数进展报警确认，它将产生确认报警事件调用格式： Ack(报警组名)； 或 Ack(变量名)； 例如： Ack(全厂)； 或 Ack(反响罐液位)；3. Average 此函数为对指定的多个变量求平均值语法格式使用如下： Average〔’a1’,’a2’〕; 或 Average('a1:a10'); a1、a2……为整型或实型变量其中参数个数为 1-32 个 当对报表的指定单元格区域的单元格进展求平均值运算时，结果显示在当前单元格，语法格式使用如下： Average〔’a1’,‘a2‘〕; 例如：=Average〔 ‘a1’,‘b2’,‘r10’〕任意单元格选择求平均值 =Average(‘b1:b10’);连续的单元格求平均值。

4.ChangePassword 此函数显示“更改口令〞对话框，允许登录工程人员更改他们的口令使用格式： ChangePassword(); 例如： 为画面上某一按钮设置命令语言连接： ChangePassword( ); 运行时单击此按钮，弹出对话框： 提示工程人员输入当前的口令和新口令以与验证新口令完全正确后，工程人员的口令设置为新值5.FileDelete 此函数删除不需要或不想要的文件调用格式：FileDelete(Filename); 参数 描述 Filename 要删除的文件名 假如找到要删除的文件，并成功地删除，此函数将返回 1，否如此此函数返回 0 例如： Status=FileDelete("C:\DATA.TXT"); 假如在 C:\找到 "DATA.TXT" 如此Status 等于 1, 未找到该文件如此为 06.GetDate 此函数将以秒为单位的长整型数转换为相应的日期数值， 分别以年、月、日等的日期数值输出该长整型秒数的基准为 UTC(格林尼治)时间 1970 年 1 月 1 日 00:00:00转换完成输出的日期也为 UTC(格林尼治)日期。

语法使用格式 GetDate(DateTime,Year,Month,Day); 参数 描述 DateTime： 需要进展日期转换的数，整型，为输入参数 Year： 年，整型或实型，转换后得到的数据，输出参数 Month： 月，整型或实型，转换后得到的数据，输出参数 Day： 日，整型或实型，转换后得到的数据，输出参数 例如： 自UTC(格林尼治)时间1970年1月1日00:00:00到2003年8 月8 日0:8:9 的秒的数值为 1060301289，使用 GetDate()函数可以从这个数值中别离出所表示的日期——年、月、日 函数 GetDate(1060301289,年,月,日); 执行后，得到的“年〞的值为 2003， “月〞 的值为 8， “日〞 的值为 8 获得其中时间的函数为 GetTime()7.HidePicture 此函数用于隐藏正在显示的画面，但并不将其从存中删除调用格式： HidePicture("画面名")； 例如： HidePicture("反响车间")；8.Int 此函数返回小于等于指定数值的最大整数。

调用格式：IntegerResult=Int(Number); 参数 描述 Number 任一数字或者组态王的实型或整型变量名 例如： Int(4.7);将返回 4 Int(-4.7);将返回 -59 . IsPlaySoundEnd 此函数用于判断声音播放是否完毕，返回值为离散型，当返回值为1 时，表示声音播放完毕；返回值为 0 时，表示声音正在播放 调用格式： IsPlaySoundEnd(); 此函数无参数 10. listAddItem 此函数将给定的列表项字符串信息 MessageTag 增加到指定的列表框控件 ControlName 中并显示出来组态王将增加的字符串信息作为列表框中的一个成员项 Item， 并自动给这个成员项定义一个索引号 ItemIndex，索引号 ItemIndex 从 1 开始由小到大自动加 1 语法格式使用如下： listAddItem("ControlName","MessageTag"); 参数说明：ControlName：工程人员定义的列表框控件名称，可以为中文名或英文名 MessageTag：字符串值，表示增加到指定列表框控件的成员项字符串信息。

例如： listAddItem("报警信息","温度报警"); 此语句将“温度报警〞 字符串信息增加到列表框控件报警信息中并显示出来 listAddItem("配方信息","巧克力面包"); 此语句将“巧克力香型面包〞 字符串信息增加到列表框控件配方信息中并显示出来 11.LogOff 此函数用于在 TOUCHVEW 中退出登录调用格式： LogOff( ); 参数 无 12.LogOn 此函数用于在 TouchVew 中登录调用格式： LogOn( ); 参数 无 例如： 为画面上某个按钮建立命令语言连接： LogOn( ); 画面程序运行时单击此按钮，弹出“登录〞对话框：工程人员在此对话框中输入用户名和口令， 以获得操作权限 13.PageDown 用于报警窗口信息的向前翻页显示调用形式： PageDown(报警窗口名，翻页行数)； 例如： PageDown(全厂历史报警记录窗口,7); 该调用将“全厂历史报警记录窗口〞的报警记录向下翻 7 行〔如果有足够报警记录的话〕 PageUp 用于报警窗口信息的向后翻页显示调用格式： Pageup(报警窗口名，翻页行数)； 例如： PageUp(全厂历史报警记录窗口,7); 该调用将“全厂历史报警记录窗口〞的报警记录向上翻 7 行〔如果有足够报警记录的话〕.14.PlayAvi 此函数用于播放动画，动画为.avi 文件。

调用格式： PlayAvi("CtrlName",filename,option); 参数与其描述CtrlName:用于播放播放 AVI 动画的控件的名称 filename:代表要播放的动画文件的字符串或字符串变量 option:可为下述之一： 0 停止播放 AVI 动画 1 播放一遍 AVI 动画 2 连续播放 AVI 动画，直到接收到停止播放的信息为止 例如： PlayAvi( "ctl_avi","c:\demo\Winner.avi",1 ); 此函数的功能是在名称为“ctl_avi〞的控件中播放Winner.avi中存放的动画，只播放一次画面停止在动画的最后15.PrintWindow 此函数打印指定窗口调用格式： PrintWindow( "Window", xScale, yScale , option, xStart, yStart); 参数 描述 Window 要打印的窗口名 xScale 打印输出的宽度占此页总宽的百分比 此参数可以取 0，以使用缺省最大的纵横比或者取一指定的宽度。

YScale 打印输出的高度占此页总高度的百分比此参数可以取 0，以使用缺省最大的纵横比或者取一指定的高度Options 离散值：0或 1，仅在 Width 和 Height 都为 0 时使用假如 Options 为 1 窗口在最大纵横比下以窗口尺寸的整数倍数打印假如 Options 为 0，以适于此页的最大纵横比打印假如窗口包含位图，置 Options 为 1，以免位图被拉长 xStart 要打印的窗口横向空白长度的百分比 YStart 要打印的窗口纵向空白长度的百分比 许多报表可通过使用此函数进展排队打印字体原样打印，对象如此被位图化而且以位图的形式打印白色背景并且仅仅包含文字的窗口可以很快打印出来假如打印彩色背景并且包含许多对象的窗口将花费较长的时间 假如要确保窗口中的文本能被正确打印，建议将所有要被打印的窗口中的文体域设置为“True Type〞字体 当打印画面上的按钮时，按钮上的文本中可能被“切除〞 ，因为用在按钮文本上的字体为“System〞字体，它不是“True Type〞字体另外， “System〞字体用在打印机上与用在屏幕上相比略有不同。

假如发生了这种情况请试着把按钮放大 如下图显示了 xScale，YScale，xStart，yStart 之间的关系:例如： 每天上午 8:30 打印三页报表，使用命令语言： if ( $时 == 8 && $分 == 30 ) { PrintWindow("1st Shift Summary",0,0,0,10,10); PrintWindow("2nd Shift Summary",0,0,0,10,10); PrintWindow("3rd Shift Summary",0,0,0,10,10); } 命令语言应用程序的执行优先于此函数的执行假如命令语言应用程序频繁运行的话，例如如每 200 毫秒运行一次，窗口的打印可能要多花费些时间16.pvSetLimits 此函数用于改变指定的温控曲线控件的温度最大值、温度最小值、温度分度数、时间最大值和时间分度数 语法格式使用如下： pvSetLimits("CtrlName",TempMax,TempMin,TempScale,TimeMax,TimeScale); 参数说明： CtrllName：工程人员定义的温控曲线控件名称，可以为中文名或英文名。

TempMax：设置温控曲线的温度最大值，可以为正数或负数 TempMin: 设置温控曲线的温度最小值，可以为正数或负数 TempScale: 设置温控曲线的温度分度数，该变量应设置为整型变量TimeMax: 设置温控曲线的时间最大值 TimeScale: 设置温控曲线的时间分度数，该变量应设置为整型变量 例如： pvSetLimits( "反响罐温控曲线",TempMax,TempMin,TempScale,TimeMax,TimeScale ); 此语句将反响罐温控曲线控件中温度最大值设置成变量TempMax 的值，将温度最小值设置成变量 TempMin 的值。