组态王命令语言函数速查手册三

止 例如：

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

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

此函数通过安装了Windows wave 形式音频设备驱动器的机器播放 声音。声音为wav 文件。调用格式： PlaySound(SoundName,Flags); 参数说明：

SoundName：代表要播放的声音文件的字符串或字符串变量。声音文 件名前可加声音文件所在的目录，也可以不加。声音文 件目录的查找按以下顺序：当前工程目录，Windows 目 录，Windows 系统目录，在SoundName 参数中列出的 目录。若缺省的目录或列出的目录中找不到该声音文 件，则不播放声音。

Flags：Flags 可为下述之一：

0：停止播放声音，注意，使用该值不能停止播放同步声音 1：同步播放声音 2：异步播放声音

3: 重复播放声音直到下次调用PlaySound() 函数为止 组态王命令语言函数速查手册 北京亚控科技发展有限公司 61

4: 蜂鸣器报警

5：停止同步播放声音。当前声音完整播放，停止的是当前声音之后 的声音 例如：

1、同步播放声音文件a，a 所在路径为当前组态王工程路径 下。

PlaySound(\2、停止播放同步声音。 PlaySound(\

注意，停止播放声音（包括同步播放和非同步播放）时，不 需要输入SoundName 参数。

PlaySound 函数在WEB 客户端使用时，其调用格式为： PlaySound(“Web”, Flags);

注意：第一个参数必须为“Web”，不区分大小写。 参数说明：

Flags：整型，播放控制，可为下述之一：

0：待机（初始）状态。客户端启动后，默认为此状态。当有报警发 生时，则进入运行态

1：消音。停止播放声音，但有新报警时，声音会重新启动

2：声音恢复：继续播放声音，配合“消音”操作使用。当处于待机 状态时，此命令无效（不会播放声音），运行态时有效（恢复播放声 音）

3: 声音提示使能：激活声音自动提示功能，当有新报警时，自动播 放声音

4: 声音提示禁止：禁止声音提示功能

5：声音测试：用于测试声音是否正常。无论待机、运行、有无报警，均播放声音提示

组态王命令语言函数速查手册 北京亚控科技发展有限公司 62

例如： 声音恢复： PlaySound(\PlaySound2

该函数为播放WAV声音文件。调用格式： PlaySound2(SoundName, DevideId, Flags); 参数：SoundName 字符串型 声音文件名称及路径 DevideId 整型 播放声音的声音设备（声卡）

序号，如果是第一块声卡，则为1，如果是第二块声卡， 则为2。

Flags 整型 对声音文件的控制。如果设为0，则 关闭当前播放的音乐；如果设为1，则当前音乐播放一 次后停止播放；如果设为2，则当前音乐播放完后继续 从头循环播放。 例如：

使用声卡播放一次“c:\\horns.wav”声音文件. PlaySound2(“c:\\horns.wav”, 1, 0); Pow

此函数求得一模拟值或模拟变量的任意次幂。调用格式： Result=Pow(x, y); 参数 描述 x 底数 y 指数

返回值为x 的y 次幂。 例如：

组态王命令语言函数速查手册 北京亚控科技发展有限公司 63

Result=Pow(2, 3); 函数调用后Result=8.0 PowerCheckUser

此函数当用户希望进行一项操作时（如分闸或合闸），为防止误操作，需要进行双重认证。即在身份认证对话框中，既要输入操作者的名 称和密码，又要输入监控者的姓名和密码，两者验证无误时方可操 作。调用该函数后，弹出身份验证对话框。如下图所示。其中使用 的用户信息是通过组态王中的用户配置得到的。 调用格式：

Result= PowerCheckUser(string OperatorName, string MonitorName); 参数 描述

OperatorName 返回的操作者姓名 MonitorName 返回的控制者姓名 Result 1：验证成功，0：验证失败 例如：

Result= PowerCheckUser(OperatorName, MonitorName); 组态王命令语言函数速查手册 北京亚控科技发展有限公司 64

PreviewWindow

该函数具有组态王画面的打印预览功能。调用格式：

PreviewWindow( \yStart); 参数说明：

Window：要打印预览的组态王窗口名，即组态王画面名称。字符串 类型。

xScale：打印输出的宽度占页面总宽度的百分比。整型或实型。此 参数为0 时，option 参数起作用。

yScale：打印输出的高度度占页面总高度的百分比。整型或实型。 此参数为0 时，option 参数起作用。

option：仅当xScale 和yScale 为0 时有效。整型，取值0 或1。 如果组态王画面上不包含位图，OCX 控件，报表，报警窗，那 么，option 为0 时, 保持画面的纵横比不变，以适合打印页面的最 大比例打印（画面不失真）；option 为1 时，按页面的大小对画面 进行缩放（画面有可能失真）。

如果组态王画面上包含位图， OCX 控件，报表，报警窗，中的 任何一个，那么，option 为1 时, 保持画面的纵横比不变，以适合 打印页面的最大比例打印（画面不失真）；option 为0 时，按页面 的大小对画面进行缩放（画面有可能失真）。

当画面上包含位图， OCX 控件，报表，报警窗时，建议将option 参数设为1。

xStart：要打印窗口的横向空白占页面宽度的百分比。整型或实型。 如果组态王画面上包含位图， OCX 控件，报表，报警窗，中的任何 一个时，xStart 参数值无意义。

yStart：要打印窗口的纵向空白占页面高度的百分比。整型或实型。 如果组态王画面上包含位图， OCX 控件，报表，报警窗，中的任何 一个时，yStart 参数值无意义。 组态王命令语言函数速查手册 北京亚控科技发展有限公司 65 注意：

1、组态王运行系统预览打印画面后，如果在开发系统对画面进行了 修改，请重新预览。

2、只能预览当前显示的画面。

3、请在组态王运行系统启动，显示运行画面之后，再进行打印预览。4、如果画面的显示尺寸小于画面的实际尺寸时（画面的显示尺寸和 实际尺寸在开发系统的画面属性中设置），预览到的画面与组态王运 行系统显示的画面相同，也就是说，预览到的是部分画面。 5、建议将画面的显示尺寸设在计算机显示屏的像素点以下。 例如：

预览报表打印窗口，可以使用下面的按钮命令语言： PreviewWindow( \报表\其中“报表”为包含报表的组态王画面名。 PrintWindow

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

PrintWindow( \yStart); 参数 描述

Window 要打印的窗口名。

xScale 打印输出的宽度占此页总宽的百分比。此参数可以 取0，以使用缺省最大的纵横比或者取一指定的宽

度。

YScale 打印输出的高度占此页总高度的百分比。此参数可 以取0，以使用缺省最大的纵横比或者取一指定的 高度。

Options 离散值：0 或1，仅在 Width 和 Height 都为 0 时 组态王命令语言函数速查手册 北京亚控科技发展有限公司 66

使用。若 Options 为1 窗口在最大纵横比下以窗 口尺寸的整数倍数打印。若 Options 为 0，以适 于此页的最大纵横比打印。若窗口包含位图，置 Options 为 1，以免位图被拉长。

xStart 要打印的窗口横向空白长度的百分比。 YStart 要打印的窗口纵向空白长度的百分比。

若要确保窗口中的文本能被正确打印，建议将所有要被打印的 窗口中的文体域设置为“True Type”字体。

当打印画面上的按钮时，按钮上的文本中可能被“切除”，因为用在按钮文本上的字体为“System”字体，它不是“True Type”字体。另外，“System”字体用在打印机上与用在屏幕上相比略有不同。若发生了这种情况。请试着把按钮放大。

下图显示了xScale，YScale，xStart，yStart 之间的关系: 例如：

PrintWindow(\反应车间 \pvAddNewRealPt

此函数用于在指定的温控曲线控件中增加一个采样实时值。 语法格式使用如下：

pvAddNewRealPt(\xScal YScale yStart xStar

组态王命令语言函数速查手册 北京亚控科技发展有限公司 67

\参数说明：

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

timeOffset：相对前一采样点的时间偏移量(即距前一值的时间间隔值)，第一个值取0。

Value：温度的采样值，实型数据，此变量通常为组态王数据库中定义的I/O 实数变量。

commentTag：注释性字符串，也可以是字符串变量，当游标移动到 此点时，给出提示性信息。 例如1：

pvAddNewRealPt( \反应罐温控曲线\温度值为38 度\

此语句在反应罐温控曲线控件中增加一个38 度的温度采样 实时值。此采样实时值距前一值的时间间隔值为1，当游标 移动到此点时，给出提示性信息“温度值为38 度”。 如2：

设反应罐实时温度是组态王数据库中定义的一个I/O 实数变 量，接收从下位机中送来的温度值，TimeString 为组态王数 据库中定义的一个字符串变量。

TimeString=StrFromInt($时)+ \分)+ \秒)

pvAddNewRealPt( \反应罐温控曲线\反应罐实时温度, TimeString );

此语句在反应罐温控曲线控件中给出变量反应罐实时温度的 采样实时值。此采样实时值距前一值的时间间隔值为10，当 游标移动到此点时，给出TimeString 中的提示性信息。 组态王命令语言函数速查手册 北京亚控科技发展有限公司 68 注意：

设定曲线将根据实时曲线第一点的位置而变。 例如:

实时曲线第一点的位置为：（用一按钮添加实时曲线第一 点）

pvAddNewRealPt( \反应罐温控曲线\TimeString );

图中为一设定曲线，按下按钮后，如下图示： 组态王命令语言函数速查手册 北京亚控科技发展有限公司 69

原设定曲线第一点（0，0）变为（0，20）； pvAddNewSetPt

此函数用于在指定的温控曲线控件中增加一段温度设定曲线。适用 于自由设定模式。 语法格式使用如下：

pvAddNewSetPt( \参数说明：

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

timeOffset：相对前一采样点的时间偏移量(即距前一值的时间间隔值)，第一个值取0。

Value：温度的设定值，实型数据。 例如：

pvAddNewSetPt( \反应罐温控曲线\

此语句在反应罐温控曲线控件中增加一段温度设定曲线，其 设定温度为38 度，此设定值距前一值的时间间隔值为1。 组态王命令语言函数速查手册 北京亚控科技发展有限公司 70 pvClear

此函数用于在指定的温控曲线控件中删除温控实时曲线或温控设定 曲线。

语法格式使用如下：

pvClear( \参数说明：

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

IsRealCurve： 确定是温控实时曲线或温控设定曲线，布尔型变量。 1 清除温控实时曲线 0 清除温控设定曲线 例如：

pvClear(\反应罐温控曲线\

此语句清除反应罐温控曲线控件中的温度设定曲线。 pvClear(\反应罐温控曲线\

此语句清除反应罐温控曲线控件中的温度实时曲线。 pvGetValue

此函数用于在指定的温控曲线控件中获取指定时刻的温度设定值或 指定时刻的温度实时值，若指定时刻无采样，则返回该时刻前最近 的一次采样值。 语法格式使用如下：

pvGetValue( \\参数说明：

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

组态王命令语言函数速查手册 北京亚控科技发展有限公司 71

timeOffset： 相对时间坐标原点的时间偏移量（也就是绝对 时间坐标），第一个值取0。

TagName： 组态王数据库中定义的I/O 实数变量。

option： 确定是温度设定值或温度实时值, 字符串常量，如 下所示。

RealValue 温度实时值 SetValue 温度设定值 例如：

pvGetValue( \反应罐温控曲线\反应罐实时温 度,\

此语句从反应罐温控曲线控件中获取指定时刻的温度实时 值，该值距坐标原点的时间间隔为5，并将该值存放到变量 反应罐实时温度中。

pvGetValue( \反应罐温控曲线\反应罐设定温 度,\

此语句从反应罐温控曲线控件中获取指定时刻的温度设定 值，该值距坐标原点的时间间隔为5，并将该值存放到变量 反应罐设定温度中。 pvIniPreCuve

此函数用于初始化设定曲线。 语法格式使用如下：

pvIniPreCuve( \参数说明：

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

fileName：fileName 文件以文本文件格式(.csv),编排格式: SetData

组态王命令语言函数速查手册 北京亚控科技发展有限公司 72

曲线点数

曲线第一点的位置

第一段升温速率,设定温度,保温时间 第二段升温速率,设定温度,保温时间 第三段升温速率,设定温度,保温时间 ...

第n 段升温速率,设定温度,保温时间 编排格式注意：

SetData、曲线点数、曲线第一点的位置末和每一段曲线参数升温速率、设定温

度、保温时间输完以后，该行末不能加空格或其他符号。 例如：

设文件 pvset.csv 以.csv 格式存放数据如下: SetData 20 39.000000

10.000000,20.000000,0 10.000000,20.000000,10 20.000000,20.000000,10 30.000000,20.000000,10 40.000000,20.000000,10

如下图所示，用计事本编写完后用.csv 为后缀存盘，则该文 件即可被此控件函数使用。

用记事本编辑格式文件的示意图如下： 组态王命令语言函数速查手册 北京亚控科技发展有限公司 73

pvIniPreCuve( \加热炉温控曲线\” ); 此语句将加热炉的初始化温控曲线设定为下图所示的曲线： pvLoadData

此函数用于从指定的文件中读取温控设定曲线或温控实时曲线的采 样历史数据值，文件名后缀必须为.csv。 语法格式使用如下：

pvLoadData( \参数说明：

ControlName：工程人员定义的温控曲线控件名称，可以为中文名或 组态王命令语言函数速查手册 北京亚控科技发展有限公司 74 英文名。

FileName： FileName 文件以.csv 格式按曲线段数、各段升温速 率、设定温度、保温时间依次存放设定温控曲线信 息或温控实时曲线的采样历史数据值，文件名后缀 必须为.csv

option： 确定是读取温控设定曲线或温控实时曲线的采样历史 数据值，字符串常量。

“RealValue” 读取温控实时曲线的采样历史数据值 “SetValue” 读取温控设定曲线 例如：

设文件以.csv 格式存放数据同初始化设定曲线的文件格式， 例如:

SetData 20 39.000000

10.000000,20.000000,0 10.000000,20.000000,10 20.000000,20.000000,10 30.000000,20.000000,10 40.000000,20.000000,10

存为c:\\setvalue.csv ，并用下面的函数调用，在温控曲线 控件中显示出来:

pvLoadData( \反应罐温控曲线\\

此语句读取温控设定曲线并传送到反应罐温控曲线控件中显 示出来。

pvLoadData( \反应罐温控曲线\\

组态王命令语言函数速查手册 北京亚控科技发展有限公司 75

此语句读取温控实时曲线的采样历史数据值并传送到反应罐 温控曲线控件中显示出来。 pvModifyPreValue

此函数用于在指定的温控曲线控件中修改某段温控设定曲线。 语法格式使用如下：

pvModifyPreValue( \timeStore ); 参数说明：

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

Index： 温控曲线段索引编号。 Tane：设置温控曲线段的升温速率。 SetValue：设置温控曲线段的设定温度。 timeStore：设置温控曲线段的保温时间。 例如：

pvModifyPreValue( \反应罐温控曲线\此语句将反应罐温控曲线控件中的第二段温控设定曲线设置 为：升温速率 20；设定温度 80；保温时间 25。 pvMoveSlide

此函数用于在指定的温控曲线控件中设置游标左移或右移。 语法格式使用如下：

pvMoveSlide( \direction, numPt ); 参数说明：

ControlName：工程人员定义的温控曲线控件名称，可以为中文名或组态王命令语言函数速查手册 北京亚控科技发展有限公司 76 英文名。

leftORrightSlide： 设置左游标或右游标。 1 左游标 0 右游标