组态王常用的函数（最新）

1.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:\\找到 \则Status 等于 1, 未找到该文件 则为 0。

6.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);将返回 -5

9 . IsPlaySoundEnd

此函数用于判断声音播放是否结束，返回值为离散型，当返回值为 1 时，表示声音播放结束；返回值为 0 时，表示声音正在播放。 调用格式：

IsPlaySoundEnd(); 此函数无参数。

10. listAddItem

此函数将给定的列表项字符串信息MessageTag增加到指定的列表 框控件ControlName中并显示出来。组态王将增加的字符串信息作 为列表框中的一个成员项 Item，并自动给这个成员项定义一个索引 号ItemIndex，索引号ItemIndex从 1 开始由小到大自动加 1。 语法格式使用如下：

listAddItem(\ 参数说明：

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:用于播放播放 AVI 动画的控件的名称。

filename:代表要播放的动画文件的字符串或字符串变量。

option:可为下述之一：

0 停止播放 AVI 动画 1 播放一遍 AVI 动画

2 连续播放 AVI 动画，直到接收到停止播放的信息为止 例如：

PlayAvi( \.avi\

此函数的功能是在名称为“ctl_avi”的控件中播放

Winner.avi中存放的动画，只播放一次。画面停止在动画的最后。

15.PrintWindow

此函数打印指定窗口。调用格式：

PrintWindow( \ 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之间的关系:

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