组态王命令语言函数手册

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

命令语言函数速查手册　

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

Ａｂｓ　

此函数用于计算变量值的绝对值，使用格式如下：　

Ａｂｓ（数值或变量名）；　返回值：整值或实型值；　例如：　

Ａｂｓ（１４）；　　返回值为１４　Ａｂｓ（－７．５）；　返回值为７．５　

Ａｂｓ（距离）；　返回内存模拟变量“距离”的绝对值。　

Ａｃｋ　

此函数常和按钮连接，当发生报警时，用此函数进行报警确认，它将产生确认报警事件。调用格式：　

Ａｃｋ（报警组名）；　　或　　Ａｃｋ（变量名）；　例如：　

Ａｃｋ（全厂）；　　或　　　Ａｃｋ（反应罐液位）；　

ＡｃｔｉｖａｔｅＡｐｐ　

此函数用于激活正在运行的窗口应用程序，使之获得输入焦点。该函数主要用于配合函数ＳｅｎｄＫｅｙｓ的使用。调用形式：　

ＡｃｔｉｖａｔｅＡｐｐ（ＡｐｐＮａｍｅ）；　

参数　　　　　　描述　ＡｐｐＮａｍｅ　　　应用程序的执行文件名　例如：　

激活Ｍｉｃｒｏｓｏｆｔ　Ｗｏｒｄ的正确调用为：　ＡｃｔｉｖａｔｅＡｐｐ（＂Ｗｏｒｄ．ｅｘｅ＂）；　　

北京亚控自动化软件科技有限公司

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

& 激活组态王： 可使用ActivateApp(\； 　　

ＡｒｃＣｏｓ　

此函数用于计算变量值的反余弦值，　变量值的取值范围在［－１，１］之间，否则函数返回值无效。调用格式：　

ＡｒｃＣｏｓ（变量名）；　返回值：整值或实型值；　例如：　

ＡｒｃＣｏｓ（１）；　此函数返回值为０　

ＡｒｃＣｏｓ（ｔｅｍｐ）；　此函数返回变量“ｔｅｍｐ”的反余弦值　

ＡｒｃＳｉｎ　

此函数用于计算变量值的反正弦值，　变量值的取值范围在［－１，１］之间，否则函数返回值无效。调用格式：　

ＡｒｃＳｉｎ（变量值）；　返回值：整值或实型值；　例如：　

ＡｒｃＳｉｎ（１）；　此函数返回值为９０　

ＡｒｃＳｉｎ（ｔｅｍｐ）；　此函数返回变量“ｔｅｍｐ”的反正弦值　

ＡｒｃＴａｎ　

此函数用于计算变量值的反正切值，　使用格式为：　

ＡｒｃＴａｎ（变量值）；　返回值：整值或实型值；　例如：　

ＡｒｃＴａｎ（１）；　此函数返回值为４５　

ＡｒｃＴａｎ　（ｔｅｍｐ）；　此函数返回变量“ｔｅｍｐ”的反正切值　

Ｂｉｔ　

此函数用以取得一个整型或实型变量某一位的值（０或１）。用法：　

北京亚控自动化软件科技有限公司

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

　ＯｎＯｆｆ＝Ｂｉｔ（　Ｖａｒ　，　ｂｉｔＮｏ）　ＯｎＯｆｆ：离散变量　Ｖａｒ：整型或实型变量　

ｂｉｔＮｏ：位的序号，取值１至１６　

返回值：若变量Ｖａｒ的第ｂｉｔＮｏ位为０，返回值ＯｎＯｆｆ为０；　　若变量Ｖａｒ的第ｂｉｔＮｏ位为１，返回值ＯｎＯｆｆ为１；　例如：　

开关＝Ｂｉｔ（ＤＤＥ１，６）；　　从变量ＤＤＥ１的第６位得到变量“开关”状态。　

ＢｉｔＳｅｔ　

此函数将一个整型或实型变量的任一位置为指定值（０或１）。用法：　

　ＢｉｔＳｅｔ（　Ｖａｒ，　ｂｉｔＮｏ，　ＯｎＯｆｆ）　Ｖａｒ：整型或实型变量　

ｂｉｔＮｏ：位的序号，取值１至１６　ＯｎＯｆｆ：位的设定值　例如如：　　

　ＢｉｔＳｅｔ（ＤＤＥ１，６，０）；　　将变量ＤＤＥ１的第６位置为０。　

ＣｈａｎｇｅＰａｓｓｗｏｒｄ　

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

ＣｈａｎｇｅＰａｓｓｗｏｒｄ（）；　例如：　

为画面上某一按钮设置命令语言连接：　ＣｈａｎｇｅＰａｓｓｗｏｒｄ（　）；　

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

北京亚控自动化软件科技有限公司

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

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

ｃｈａｒｔＡｄｄ（）　

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

ｃｈａｒｔＡｄｄ（　＂ＣｏｎｔｒｏｌＮａｍｅ＂，　Ｖａｌｕｅ，　＂ｌａｂｅｌ＂　）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的棒图控件名称，可以为中文名或英文名。　

Ｖａｌｕｅ：设定条形图的初始值，整形数据，　实型数据。　

ｌａｂｅｌ：设定条形图的标签值，默认值＝索引值Ｉｎｄｅｘ，Ｉｎｄｅｘ的取值范围是１－１６。　例如：　

ｃｈａｒｔＡｄｄ（　＂ＸＹＣｈａｒｔ＂，　１，　＂Ｌ６＂　）；　

此语句将在棒图控件ＸＹＣｈａｒｔ中增加一个标签为Ｌ６的条形图，其初始值为１。　

ｃｈａｒｔＣｌｅａｒ（）　

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

ｃｈａｒｔＣｌｅａｒ（　＂ＣｏｎｔｒｏｌＮａｍｅ＂　）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的棒图控件名称，可以为中文名或英文名。　

北京亚控自动化软件科技有限公司

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

例如：　

ｃｈａｒｔＣｌｅａｒ（　＂ＸＹＣｈａｒｔ＂　）；　

此语句把棒图控件ＸＹＣｈａｒｔ中的所有棒图清除。　

ｃｈａｒｔＳｅｔＢａｒＣｏｌｏｒ（）　

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

ｃｈａｒｔＳｅｔＢａｒＣｏｌｏｒ（　＂ＣｏｎｔｒｏｌＮａｍｅ＂，　ｂａｒＩｎｄｅｘ，　ｃｏｌｏｒＩｎｄｅｘ　）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的棒图控件名称，可以为中文名或英文名。　

ｂａｒＩｎｄｅｘ：　　　整型变量，表示条形图索引号，用于设定指定的条形图，其取值范围为１－１６。　

ｃｏｌｏｒＩｎｄｅｘ：　　整型变量，表示条形图的颜色索引号，用于设置指定条形图的颜色，其取值范围为１－１６，颜色索引号和相应的颜色如下所示。　

颜色索引号　代表颜色　　　颜色索引号　　　　代表颜色　０　　　　Ｄｅｆａｕｌｔ　　　　８　　　　　Ｇｒａｙ　１　　　　Ｂｌｕｅ　　　　　９　　　　　Ｌｉｇｈｔ　Ｂｌｕｅ　２　　　　Ｇｒｅｅｎ　　　　１０　　　　　Ｌｉｇｈｔ　Ｇｒｅｅｎ　３　　　　Ｃｙａｎ　　　　　　　　１１　　　　　Ｌｉｇｈｔ　Ｃｙａｎ　４　　　　Ｒｅｄ　　　　　１２　　　　　Ｌｉｇｈｔ　Ｒｅｄ　５　　　　Ｍａｇｅｎｔａ　　　　１３　　　　　Ｌｉｇｈｔ　Ｍａｇｅｎｔａ　６　　　　Ｙｅｌｌｏｗ　　　　１４　　　　　Ｌｉｇｈｔ　Ｙｅｌｌｏｗ　７　　　　Ｗｈｉｔｅ　　　　１５　　　　　Ｂｒｉｇｈｔ　Ｗｈｉｔｅ　　　　　　　　　　１６　　　　　Ｂｌａｃｋ　例如：　

ｃｈａｒｔＳｅｔＢａｒＣｏｌｏｒ（　＂ＸＹＣｈａｒｔ＂，　０，　１　）；　

此语句将棒图控件ＸＹＣｈａｒｔ中第一块饼图的颜色设为ｂｌｕｅ（即兰色）。　

ｃｈａｒｔＳｅｔＢａｒＣｏｌｏｒ（　＂ＸＹＣｈａｒｔ＂，　２，　４　）；　

此语句将棒图控件ＸＹＣｈａｒｔ中第三块饼图的颜色设为ｒｅｄ（即

北京亚控自动化软件科技有限公司

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

红色）。　

ｃｈａｒｔＳｅｔＶａｌｕｅ（）　

此函数用于在指定的棒图控件中设定／修改索引值为Ｉｎｄｅｘ的条形图的数据。　

语法格式使用如下：　

ｃｈａｒｔＳｅｔＶａｌｕｅ（　＂ＣｏｎｔｒｏｌＮａｍｅ＂，　Ｉｎｄｅｘ，　Ｖａｌｕｅ　）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的棒图控件名称，可以为中文名或英文名。　

Ｖａｌｕｅ：设定条形图的数据，整形数据，　实型数据。　Ｉｎｄｅｘ：条形图的标签值，，Ｉｎｄｅｘ的取值范围是１－１６，组态王自动从０开始加１，给每一个新增加的条形图由小到大设定标签值。　例如：　

ｃｈａｒｔＳｅｔＶａｌｕｅ（　＂ＸＹＣｈａｒｔ＂，２，　３０）；　

此语句将在棒图控件ＸＹＣｈａｒｔ中设定索引值为２（第三条）的条形图的数据为　３０。　

ＣｌｏｓｅＰｉｃｔｕｒｅ　

此函数用于将已调入内存的画面关闭，并从内存中删除。调用形式：　

ＣｌｏｓｅＰｉｃｔｕｒｅ（＂画面名＂）；　例如：　

ＣｌｏｓｅＰｉｃｔｕｒｅ（＂反应车间＂）；　　将关闭画面“反应车间”。　

Ｃｏｓ　

此函数用于计算变量值的余弦值，　有效使用格式如下：　Ｃｏｓ（数值或变量名）；　例如：　

Ｃｏｓ（９０）；　　　返回值为０　

Ｃｏｓ（ｔｅｍｐ）；　返回变量“ｔｅｍｐ”的余弦值。　

ＤｉｓｐｌａｙＭＣＩ　

此函数提供了一个对多媒体设备的通用接口，具有强大的功能。下面举例说明此函数的使用方法。　例如：　

北京亚控自动化软件科技有限公司

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

ＤｉｓｐｌａｙＭＣＩ（“ＰＬＡＹＣＤ”，３）　

用于播放ＣＤ唱片中的第３支歌曲。　　ＤｉｓｐｌａｙＭＣＩ（“ＳＴＯＰＣＤ”，””）　用于停止播放ＣＤ。　ＤｉｓｐｌａｙＭＣＩ（“ＰＬＡＹＭＩＤＩ”，”ｃ：＼ｍｉｄｉ．ｍｉｄ”）　用于播放ＭＩＤＩ格式的背景音乐”ｃ：＼ｍｉｄｉ．ｍｉｄ”。　ＤｉｓｐｌａｙＭＣＩ（“ＰＡＵＳＥＭＩＤＩ”，”　ｃ：＼ｍｉｄｉ．ｍｉｄ”）　暂停播放ＭＩＤＩ格式的背景音乐”ｃ：＼ｍｉｄｉ．ｍｉｄ”。　ＤｉｓｐｌａｙＭＣＩ（“ＲＥＳＵＭＭＩＤＩ”，”　ｃ：＼ｍｉｄｉ．ｍｉｄ”）　继续播放ＭＩＤＩ格式的背景音乐”ｃ：＼ｍｉｄｉ．ｍｉｄ”。　ＤｉｓｐｌａｙＭＣＩ（“ＣＬＯＳＥＭＩＤＩ”，”　ｃ：＼ｍｉｄｉ．ｍｉｄ”）　停止播放ＭＩＤＩ格式的背景音乐”ｃ：＼ｍｉｄｉ．ｍｉｄ”。　ＤｉｓｐｌａｙＭＣＩ（“ＥＪＥＣＴＣＤ”）　将光驱中的ＣＤ盘片弹出。　

Ｄｔｅｘｔ　

此函数用于按离散变量的值动态地改变字符串变量。调用形式：　

Ｓｔｒ　　＝　　Ｄｔｅｘｔ（Ｄｉｓ，Ｓｔｒｉｎｇ１，Ｓｔｒｉｎｇ２）；　　

参数　描述　Ｄｉｓ　离散变量名。　Ｓｔｒｉｎｇ１　字符串变量名　Ｓｔｒｉｎｇ２　字符串变量名　

当Ｄｉｓ＝１时，Ｓｔｒ的值为Ｓｔｒｉｎｇ１　当Ｄｉｓ＝０时，Ｓｔｒ的值为Ｓｔｒｉｎｇ２　例如：　

Ｓｔｒ　　＝　　Ｄｔｅｘｔ（电源开关，＂电源打开＂，＂电源关闭＂）；　当电源开关＝１时，Ｓｔｒ的值为＂电源打开＂　当电源开关＝０时，Ｓｔｒ的值为＂电源关闭＂。　

ＥｄｉｔＵｓｅｒｓ　

此函数常用于按钮的命令语言连接，功能是在画面程序运行中配置工程人员。调用形式：　

ＥｄｉｔＵｓｅｒｓ（　）；　

北京亚控自动化软件科技有限公司

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

为配置其他工程人员，当前工程人员的权限必须不小于９００。　　

Ｅｘｉｔ（　）　

此函数使组态王运行环境退出。调用形式：　

Ｅｘｉｔ（Ｏｐｔｉｏｎ）；　参数：　

Ｏｐｔｉｏｎ：　整型变量或数值　０－退出当前程序；　１－关机；　

２－重新启动ｗｉｎｄｏｗｓ；　

Ｅｘｐ　

此函数返回指数函数ｅｘ的计算结果，使用格式如下：　

Ｅｘｐ（数值或变量值）；　例如：　

Ｅｘｐ（１）；　　　　　返回ｅ１的计算值２．７１８　

Ｅｘｐ（ｔｅｍｐ）；　　计算ｅ常量的ｔｅｍｐ次幂并返回计算结果。　

ＦｉｌｅＣｏｐｙ　

此函数复制一个源文件到目的文件，它与　ＤＯＳ　的　Ｃｏｐｙ　命令或者　Ｗｉｎｄｏｗｓ　文件管理器中的　Ｃｏｐｙ　功能相似。调用格式：　

ＦｉｌｅＣｏｐｙ（　ＳｏｕｒｃｅＦｉｌｅ，ＤｅｓｔＦｉｌｅ，ＤｏｎｅＴａｇ）；　

参数　

ＳｏｕｒｃｅＦｉｌｅ　ＤｅｓｔＦｉｌｅ　ＤｏｎｅＴａｇ　

描述　

源文件名（包含完整的路径）。　

目的文件（包含完整的路径）或目录名（参见下面的例如子）。　

用来报告复制过程进展情况的变量名称。此参数须是一个内存长整数或内存模拟型，随着复制过程的进行，　该值从０变化到１００。　

返回值：　

成功返回１；　

北京亚控自动化软件科技有限公司

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

不能启动返回０；　出错返回－１；　

例如：　

Ｓｔａｔｕｓ＝ＦｉｌｅＣｏｐｙ（＂Ｃ：＼＊．ＴＸＴ＂，　＂Ｃ：＼ＢＡＣＫＵＰ＂，　Ｍｏｎｉｔｏｒ）；　Ｓｔａｔｕｓ：一个将被写为１、－１或０的整型变量。　Ｍｏｎｉｔｏｒ　：在数据词典中定义过的内存整数。　

ＦｉｌｅＣｏｐｙ（）函数在后台执行，这样它不会干扰组态王　的运行。ＤｏｎｅＴａｇ　允许此复制操作的进展被应用程序或工程人员监视。用这种方法，在复制过程启动后可能发生的任何错误都能使用察觉（此处用变量Ｍｏｎｉｔｏｒ监测）。这与上述返回的　Ｓｔａｔｕｓ　不同，Ｓｔａｔｕｓ　表明的是复制过程是否已成功启动。一旦复制过程已成功启动，Ｍｏｎｉｔｏｒ　就会被赋值０。随着复制过程的进行，该值不断增加。当达到１００时，此过程成功结束，Ｓｔａｔｕｓ被置为１。若此过程结束前发生错误，则Ｓｔａｔｕｓ被置为－１。　

ＳｏｕｒｃｅＦｉｌｅ　和　ＤｅｓｔＦｉｌｅ　一般为文件名。但用ＦｉｌｅＣｏｐｙ（）　函数复制单一文件时，目标文件名可以是一个目录，　如：　

ＦｉｌｅＣｏｐｙ（＂Ｃ：＼ＤＡＴＡ．ＴＸＴ＂，　＂Ｃ：＼ＢＡＣＫＵＰ＂，　Ｍｏｎｉｔｏｒ）；　将把文件“ＤＡＴＡ．ＴＸＴ”复制到“Ｃ：＼”驱动器上一个叫做“ＢＡＣＫＵＰ”的目录下。变量　Ｍｏｎｃｔｏｒ　在复制完成后置为１。　

若　ＳｏｕｒｃｅＦｉｌｅ　包含任何通配符的话，ＤｅｓｔＦｉｌｅ　必须是一个目录（而非文件名），否则此函数将返回一个错误代码，　如：　

ＦｉｌｅＣｏｐｙ（＂Ｃ：＼＊．ＴＸＴ＂，　＂Ｃ：＼ＢＡＣＫＵＰ＂，　Ｍｏｎｉｔｏｒ）；　

将把Ｃ盘根目录下所有的．ＴＸＴ文件复制到Ｃ：＼ＢＡＣＫＵＰ目录下，Ｍｏｎｉｔｏｒ在复制完成后置１００。　

ＦｉｌｅＤｅｌｅｔｅ　

此函数删除不需要或不想要的文件。调用格式：　

ＦｉｌｅＤｅｌｅｔｅ（Ｆｉｌｅｎａｍｅ）；　参数　　　　　　　　　描述　

北京亚控自动化软件科技有限公司

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

Ｆｉｌｅｎａｍｅ　　　　　要删除的文件名。　

若找到要删除的文件，并成功地删除，此函数将返回１，否则此函数返回０。　　例如：　

Ｓｔａｔｕｓ＝ＦｉｌｅＤｅｌｅｔｅ（＂Ｃ：＼ＤＡＴＡ．ＴＸＴ＂）；　　

若在　Ｃ：＼找到　＂ＤＡＴＡ．ＴＸＴ＂　则Ｓｔａｔｕｓ　等于１，　未找到该文件则为０。　

ＦｉｌｅＭｏｖｅ　

此函数与　ＦｉｌｅＣｏｐｙ　（）函数相似，但只是将文件从一个位置转移到另一个位置，而不是复制。调用格式：　

ＦｉｌｅＭｏｖｅ（ＳｏｕｒｃｅＦｉｌｅ，　ＤｅｓｔＦｉｌｅ，　ＤｏｎｅＴａｇ）；　参数　描述　ＳｏｕｒｃｅＦｉｌｅ　源文件名（包含完整的路径）　ＤｅｓｔＦｉｌｅ　目的文件名（包含完整的路径）　ＤｏｎｅＴａｇ　用来报告移动过程进展情况的变量名称。此

参数须是一个内存长整数或内存模拟型，随着转移过程的进行，　该值从０变化到１００。　

返回值：　成功返回１；　不能启动返回０；　出错返回－１；　例如：　

Ｓｔａｔｕｓ＝ＦｉｌｅＭｏｖｅ（＂Ｃ：＼ＤＡＴＡ．ＴＸＴ＂，＂Ｄ：＼ＤＡＴＡ．ＴＸＴ＂，Ｍｏｎｉｔｏｒ）；　Ｓｔａｔｕｓ　是一个将被写为１、－１或０的整型变量。　Ｍｏｎｉｔｏｒ　：在数据词典中定义过的内存整数。　

ＦｉｌｅＭｏｖｅ（）　函数在后台执行，这样它不会干扰“组态王”的运行。使用　ＤｏｎｅＴａｇ　是为了允许应用程序或工程人员监视转移操作的进展。用这种方法，在转移过程启动后可能发生的任何错误都能使工程人员察觉。（此处用变量Ｍｏｎｉｔｏｒ监测）这与上述返回的Ｓｔａｔｕｓ不同，Ｓｔａｔｕｓ表明的是转移过程是否已成功启动。一旦转移过程已成功启动，Ｍｏｎｉｔｏｒ　就会被赋值

北京亚控自动化软件科技有限公司

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

０。随着转移过程的进行，该值不断增加。当此过程成功结束时达到１００，Ｓｔａｔｕｓ被置为１。若此过程结束前发生错误，Ｓｔａｔｕｓ被置为－１。　

若源文件和目的文件位于同一驱动器上，此函数可以简单地更改此文件的目录参照表（计算机在此表中保存磁盘上的文件名和存储位置），而不用实际转移任何数据。在这种情况下，不管此文件的大小，转移操作将会很快。若源文件和目的文件位于不同的驱动器上，转移操作所费的时间将随文件的大小不同而不同。这是因为数据必须由一个物理磁盘传送到另一物理磁盘上，　如：　

ＦｉｌｅＭｏｖｅ（＂Ｃ：＼ＤＡＴＡ．ＴＸＴ＂，＂Ｃ：＼ＢＡＣＫＵＰ＼ＤＡＴＡ．ＴＸＴ＂，Ｍｏｎｉｔｏｒ）；　

将把“Ｃ”驱动器上根目录下的名为“ＤＡＴＡ．ＴＸＴ的文件转移到名为“ＢＡＣＫＵＰ”的目录下，变量　Ｍｏｎｉｔｏｒ　在转移完成后将被置为　１。　

此函数也可用于文件更名，只要源文件和目的文件指定了相同的目录，但不同的文件名，　如：　

ＦｉｌｅＭｏｖｅ　（＂Ｃ：＼ＤＡＴＡ．ＴＸＴ＂，＂Ｃ：＼ＤＡＴＡ．ＢＡＫ＂，Ｍｏｎｉｔｏｒ）；　

将把Ｃ盘根目录下文件“ＤＡＴＡ．ＴＸＴ”更名为“ＤＡＴＡ．ＢＡＫ”。变量Ｍｏｎｉｔｏｒ　在其完成后被置为１。　　

ＦｉｌｅＲｅａｄＦｉｅｌｄｓ　

此函数从一个指定文件中读出　ＣＳＶ（逗号分隔变量）记录。调用格式：　

ＦｉｌｅＲｅａｄＦｉｅｌｄｓ（Ｆｉｌｅｎａｍｅ，ＦｉｌｅＯｆｆｓｅｔ，ＳｔａｒｔＴａｇ，ＮｕｍｂｅｒＯｆＦｉｅｌｄｓ）；　参数　描述　Ｆｉｌｅｎａｍｅ　　指定要读的文件。　ＦｉｌｅＯｆｆｓｅｔ　指定读此文件的起始位置。若为１，则表明

从头开始　

ＳｔａｒｔＴａｇ　指定第一个数据要写到的那个组态王变量

的名称。此变量名必须以一个数字结尾（如

北京亚控自动化软件科技有限公司

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

ＭｙＴａｇ１）。此参数必须是一个表明变量名的

字符串（而非实际的变量本身）。所以，若变量叫做　ＭｙＴａｇ１，就需要给出ＭｙＴａｇ１或　ＭｙＴａｇ１．ｎａｍｅ，而不仅仅是ＭｙＴａｇ１。　

ＮｕｍｂｅｒＯｆＦｉｅｌｄｓ　指定要读的字段数目（此文件的每条记录中

以逗号隔开的字段的数目）。　

若ＳｔａｒｔＴａｇ　为“ＭｙＴａｇ１”而ＮｕｍｂｅｒＯｆＦｉｅｌｄ为３，则有３个字段从文件中读出并保存在ＭｙＴａｇ１、ＭｙＴａｇ２和ＭｙＴａｇ３中。这些具有连续名字的变量必须先在组态王中创建，并可以属于不同的类型（整型，文字等等）。　例如：　

若Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ的第一行为：　“Ｔｈｉｓ　ｉｓ　ｔｅｘｔ，　３．１４１６，　５”，调用函数　

ＢｙｔｅＰｏｓｉｔｉｏｎ＝ＦｉｌｅＲｅａｄＦｉｅｌｄｓ（＂Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ＂，１，　＂ＭｙＴａｇ１＂，　３）；　

将读出此行，并把“Ｔｈｉｓ　ｉｓ　ｔｅｘｔ＂保存在ＭｙＴａｇ１中，３．１４１６保存在　ＭｙＴａｇ２中，５保存在　ＭｙＴａｇ３中：　

此函数在读出之后返回新的字节位置。你可以在下次读时使用此返回值作为ＦｉｌｅＯｆｆｓｅｔ的值，如：　

ＢｙｔｅＰｏｓｉｔｉｏｎ＝ＦｉｌｅＲｅａｄＦｉｅｌｄｓ（ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ＂，ＦｉｌｅＯｆｆｓｅｔ，＂ＭｙＴａｇ１＂，３）；　注意：　

ＳｔａｒｔＴａｇ　两侧必须加引号。　　

ＦｉｌｅＲｅａｄＳｔｒ　

此函数从指定文件中读出一指定数目的字节（或一整行）。调用格式：　

ＦｉｌｅＲｅａｄＳｔｒ（Ｆｉｌｅｎａｍｅ，ＦｉｌｅＯｆｆｓｅｔ，Ｍｅｓｓａｇｅ＿Ｔａｇ，ＣｈａｒｓＴｏＲｅａｄ）；　参数　描述　Ｆｉｌｅｎａｍｅ　指定要读的文件。　ＦｉｌｅＯｆｆｓｅｔ　指定读此文件的起始位置。若为１，则表明

从头开始。　

Ｍｅｓｓａｇｅ＿Ｔａｇ　指定将从文件中读出的数据保存于何处。　　

北京亚控自动化软件科技有限公司

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

指定要从文件中读出多少字节。为处理文本文件，可将ＣｈａｒｓＴｏＲｅａｄ置为０，函数从文件中一直读到下一个　ＬＦ（换行符）。　

此函数在读出之后返回新的字节位置。可以在在下次读时使用此返回值作为　ＦｉｌｅＯｆｆｓｅｔ　值。　例如：　

ＦｉｌｅＲｅａｄＳｔｒ　（＂Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＴＸＴ＂，　１，　ＭｓｇＴａｇ，　０）；　文件“Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＴＸＴ”的第一行将被读出并保存到　ＭｓｇＴａｇ　中。　　

ＦｉｌｅＷｒｉｔｅＦｉｅｌｄｓ　

此函数往指定文件写入ＣＳＶ（逗号分隔变量）记录。调用格式：　

ＦｉｌｅＷｒｉｔｅＦｉｅｌｄｓ（Ｆｉｌｅｎａｍｅ，ＦｉｌｅＯｆｆｓｅｔ，ＳｔａｒｔＴａｇ，ＮｕｍｂｅｒＯｆＦｉｅｌｄｓ）；　参数　描述　Ｆｉｌｅｎａｍｅ　　指定要写的文件。若文件不存在，则创建它。　ＦｉｌｅＯｆｆｓｅｔ　指定写此文件的起始位置。若　ＦｉｌｅＯｆｆｓｅｔ　为　０，

此函数将写到文件末尾。若为１，则写到开头。　

ＳｔａｒｔＴａｇ　指定第一个数据项的变量名称。此变量名必须以

一个数字结尾（如ＭｙＴａｇ１）。此参数必须是一个表明变量名的字符串（而非实际的变量本身）。比如，变量名为ＭｙＴａｇ１，就需要给出”ＭｙＴａｇ１”（注意引号）或ＭｙＴａｇ１．ｎａｍｅ，而不仅仅是ＭｙＴａｇ１。　

ＮｕｍｂｅｒＯｆＦｉｅｌｄｓ　指定要写的字段数目（此文件的每条记录中以逗

号隔开的字段的字段数目）。　

此函数在写入之后返回新的字节位置。可以在下次调用函数时使用此返回值作为ＦｉｌｅＯｆｆｓｅｔ值。　

若　ＳｔａｒｔＴａｇ为“ＭｙＴａｇ１”，而ＮｕｍｂｅｒＯｆＦｉｅｌｄｓ为３，则有３个字段被写入文件中（写入的是　ＭｙＴａｇ１、ＭｙＴａｇ２　和　ＭｙＴａｇ３）。这些具有连续名字的变量必须先在组态王中创建，并可以属于不同的类型（整型，字符串等等）。　例如：　

将一行“Ｔｈｉｓ　ｉｓ　ｔｅｘｔ　３．１４１６，５”写到文件Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ

北京亚控自动化软件科技有限公司

ＣｈａｒｓＴｏＲｅａｄ　

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

的第一行中。“Ｔｈｉｓ　ｉｓ　ｔｅｘｔ”是　ＭｙＴａｇ１的当前值，３．１４１６

是　ＭｙＴａｇ２的当前值，５是　ＭｙＴａｇ３的当前值。调用函数　

　　　ＦｉｌｅＷｒｉｔｅＦｉｅｌｄｓ　（＂Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ＂，　１，　＂ＭｙＴａｇ１＂，　３）；　

若将文本串ＭｙＴａｇ１写到Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ的末尾，调用函数　

　　　ＦｉｌｅＷｒｉｔｅＦｉｅｌｄｓ　（＂Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ＂，　０，　＂ＭｙＴａｇ１＂，　３）；　

ＳｔａｒｔＴａｇ　两侧必须加引号。　

ＦｉｌｅＷｒｉｔｅＳｔｒ　

此函数往指定文件写入指定数目的字节（或一整行）。调用格式：　

ＦｉｌｅＷｒｉｔｅＳｔｒ（Ｆｉｌｅｎａｍｅ，ＦｉｌｅＯｆｆｓｅｔ，Ｍｅｓｓａｇｅ，ＬｉｎｅＦｅｅｄ）；　参数　描述　Ｆｉｌｅｎａｍｅ　指定写入的文件。若文件不存在，则创建它。　ＦｉｌｅＯｆｆｓｅｔ　指定此文件的起始位置。若　ＦｉｌｅＯｆｆｓｅｔ　为　０，　

此函数将写到文件末尾。若为１，则写到开头　　

Ｍｅｓｓａｇｅ　指定要写入文件中的字符。　ＬｉｎｅＦｅｅｄ　规定是否在写操作之后添加换行。当写入一文本文件时，

可以把ＬｉｎｅＦｅｅｄ　置为１。　

此函数在写入后返回新的字节位置。你可以在下次写时将此返回值当作ＦｉｌｅＯｆｆｓｅｔ（）　函数的返回值来使用。　例如：　

将名为ＭｓｇＴａｇ的字符串变量写入文件Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＴＸＴ的末尾。调用函数ＦｉｌｅＷｒｉｔｅＳｔｒ　（＂Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＴＸＴ＂，　０，　ＭｓｇＴａｇ，　１）；　　

ＨｉｄｅＰｉｃｔｕｒｅ　

此函数用于隐藏正在显示的画面，但并不将其从内存中删除。调用格式：　

ＨｉｄｅＰｉｃｔｕｒｅ（＂画面名＂）；　例如：　

ＨｉｄｅＰｉｃｔｕｒｅ（＂反应车间＂）；　

北京亚控自动化软件科技有限公司

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

ＨＴＣｏｎｖｅｒｔＴｉｍｅ　

此函数将指定的时间格式（年，月，日，时，分，秒）转换为以秒为单位的长整型数，转换的时间基准是１９６９年１２月３１日１６：００：００。　语法使用格式　

ＨＴＣｏｎｖｅｒｔＴｉｍｅ（Ｙｅａｒ，Ｍｏｎｔｈ，Ｄａｙ，Ｈｏｕｒ，Ｍｉｎｕｔｅ，Ｓｅｃｏｎｄ）；　

参数　　　　　　　　　　描述　Ｙｅａｒ：　　年，整型，此值必须介于１９７０和２０１９之间　Ｍｏｎｔｈ：　　月，整型，此值必须介于１和１２之间　Ｄａｙ：　　　　　　日，整型，此值必须介于１和３１之间　Ｈｏｕｒ：　　　　　小时，整型，此值必须介于０和２３之间　Ｍｉｎｕｔｅ：　　　分钟，整型，此值必须介于０和５９之间　Ｓｅｃｏｎｄ：　　　秒，整型，此值必须介于０和５９之间　注：　

调用此函数将用年、月、日、时、分、秒表示的时间转换成自１９６９年１２月３１日１６：００：００即ＵＣＴ起到该时刻所经过的秒数　例如：　

语句ＨＴＣｏｎｖｅｒｔＴｉｍｅ（１９７０，１，１，１，０，０）执行后返回长整型数为３２４００；　　

ＨＴＧｅｔＰｅｎＮａｍｅ　

此函数返回指定趋势的指定笔号当前所用的变量名。调用格式：　

ＭｅｓｓａｇｅＲｅｓｕｌｔ＝ＨＴＧｅｔＰｅｎＮａｍｅ（Ｈｉｓｔ＿Ｔａｇ　，　ＰｅｎＮｕｍ）；　参数　　　　　描述　

Ｈｉｓｔ＿Ｔａｇ　　历史趋势变量，代表趋势名称。　ＰｅｎＮｕｍ　　表示笔号的整型变量或整数值（从１到８）。函数将返

回代表此指定笔的字符串变量。　

例如：　

用变量名Ｔｒｅｎｄ１检索趋势笔Ｐｅｎ２的变量名，并将结果放在字符串变量　ＴｒｅｎｄＰｅｎ　中。调用函数　

ＴｒｅｎｄＰｅｎ＝ＨＴＧｅｔＰｅｎＮａｍｅ（Ｔｒｅｎｄ１　，　２　）；　　

北京亚控自动化软件科技有限公司

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

ＨＴＧｅｔＰｅｎＲｅａｌＶａｌｕｅ　

此函数用于获取指定历史趋势曲线中的趋势笔所对应的实际值。　

调用格式：　

ＨＴＧｅｔＰｅｎＲｅａｌＶａｌｕｅ（ＨｉｓｔｒｏｙＮａｍｅ，ＰｅｎＮｕｍ，ＣｏｎｔｅｎｔＳｔｒｉｎｇ）　

参数说明　

ＨｉｓｔｒｏｙＮａｍｅ　　　指在“历史趋势曲线”对话框中定义的历史趋势曲线

名称　

ＰｅｎＮｕｍ　　　　　　　与历史趋势曲线中的一个变量相对应的趋势笔的索引

号　

ＣｏｎｔｅｎｔＳｔｒｉｎｇ　　　字符串常量　

“ｓｔａｒｔ”　　表示获取与历史趋势曲线的域ＶａｌｕｅＳｔａｒｔ相对应的

实际值，ＶａｌｕｅＳｔａｒｔ是用工程百分比来表示变量的下限值，ｓｔａｒｔ则表示将下限值的工程百分比转换为实际值。　

“ｅｎｄ”　　　表示获取与历史趋势曲线的域ＶａｌｕｅＥｎｄ相对应的实

际值，ＶａｌｕｅＥｎｄ是用工程百分比来表示变量的上限值，ｅｎｄ则表示将上限值的工程百分比转换为实际值。　

例如：　

设有一温度历史曲线，其最大上限值为５００，最小下限值为０，　如下图所示：　

最大上限值 500 对应的工程百分比为100% 对应的工程百分比为0% 最小下限值 0 　　　

如果用ＶａｌｕｅＳｔａｒｔ和ＶａｌｕｅＥｎｄ输出显示，则显示的数据是温度值的工程百分比，如ＶａｌｕｅＥｎｄ　的输出为５０，表示百分比是

北京亚控自动化软件科技有限公司

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

５０％，如果使用函数语句　

　　　　　ＨＴＧｅｔＰｅｎＲｅａｌＶａｌｕｅ（ｈｉｓｔｒｏｙ，１，“ｅｎｄ”）；　

则函数返回工程百分比５０％对应的实际值５００＊５０％＝２５０，其中ｈｉｓｔｏｒｙ为历史趋势曲线名，１表示对应温度的趋势笔。　

ＨＴＧｅｔＴｉｍｅＡｔＳｃｏｏｔｅｒ　

此函数返回一个长整数，表示以ＧＭＴ（格林尼治时间）１９６９年１２月３１日１６：００：００为起点的以秒计的相对时间，指示器位置由　ＳｃｏｏｔＮｕｍ　和　ＳｃｏｏｔＬｏｃ　指定。　调用格式：　

ＩｎｔｅｇｅｒＲｅｓｕｌｔ＝ＨＴＧｅｔＴｉｍｅＡｔＳｃｏｏｔｅｒ（Ｈｉｓｔ＿Ｔａｇ，　ＳｃｏｏｔＮｕｍ　）；　参数　描述　

Ｈｉｓｔ＿Ｔａｇ　历史趋势变量，代表趋势名。　

ＳｃｏｏｔＮｕｍ　整数，代表左或右指示器（１＝左指示器，２＝右指示器）。　当趋势曲线的ＣｈａｒｔＳｔａｒｔ、ＣｈａｒｔＬｅｎｇｔｈ、ＳｃｏｏｔＮｕｍ或指示器位置改变时都会引起此表达式被计算。　例如：　

下面的语句在趋势曲线Ｔｒｅｎｄ１左指示器的当前位置给出以秒为单位的时间值：　

ＴｉｍｅＬｅｎｇｔｈ＝ＨＴＧｅｔＴｉｍｅＡｔＳｃｏｏｔｅｒ（Ｔｒｅｎｄ１　，１）；　　

ＨＴＧｅｔＴｉｍｅＳｔｒｉｎｇＡｔＳｃｏｏｔｅｒ　

此函数返回包含时间／日期的字符串，指示器的位置由　ＳｃｏｏｔＮｕｍ　和　ＳｃｏｏｔＬｏｃ　指定。调用格式：　

ＭｅｓｓａｇｅＲｅｓｕｌｔ＝ＨＴＧｅｔＴｉｍｅＳｔｒｉｎｇＡｔＳｃｏｏｔｅｒ（Ｈｉｓｔ＿Ｔａｇ，　ＳｃｏｏｔＮｕｍ　，　Ｆｏｒｍａｔ＿Ｔｅｘｔ）；　

参数　描述　Ｈｉｓｔ＿Ｔａｇ　　历史趋势变量，代表趋势名。　ＳｃｏｏｔＮｕｍ　　整数，代表左或右指示器（１＝左指示器，２＝右指示

器）。　

Ｆｏｒｍａｔ＿Ｔｅｘｔ　　指定要使用的时间／时期格式的字符串。可为下列值

之一。　

＂Ｄａｔｅ＂　以　Ｗｉｎｄｏｗｓ　控制面板相同的格式显示日期。　

北京亚控自动化软件科技有限公司

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

＂Ｔｉｍｅ＂　

＂ＤａｔｅＴｉｍｅ＂　以　Ｗｉｎｄｏｗｓ　控制面板相同的格式显示时间。　同时显示日期和时间。　

当趋势曲线的ＣｈａｒｔＳｔａｒｔ、ＣｈａｒｔＬｅｎｇｔｈ、ＳｃｏｏｔＮｕｍ或指示器位置改变时都会引起此表达式被计算。字符串的格式决定了返回值的内容。．　例如：　

在变量为Ｔｒｅｎｄ１的右指示器的当前位置给出日期／时间值。这个值被存在字符串变量　ＮｅｗＲｉｇｈｔＴｉｍｅＳｔｒｉｎｇ　中，格式是”Ｔｉｍｅ”，调用函数　

ＮｅｗＲｉｇｈｔＴｉｍｅＳｔｒｉｎｇ＝ＨＴＧｅｔＴｉｍｅＳｔｒｉｎｇＡｔＳｃｏｏｔｅｒ　（　Ｔｒｅｎｄ１，　２，　＂Ｔｉｍｅ＂　）；　

ＨＴＧｅｔＶａｌｕｅ　

此函数返回一个按整个趋势的指定笔所要求的类型的值。调用格式：　

ＲｅａｌＲｅｓｕｌｔ＝ＨＴＧｅｔＶａｌｕｅ（Ｈｉｓｔ＿Ｔａｇ，　ＰｅｎＮｕｍ，ＶａｌＴｙｐｅ＿Ｔｅｘｔ）；　

参数　　　　　　　　　　　　　　　　　　　　　　　描述　Ｈｉｓｔ＿Ｔａｇ　　历史趋势变量，代表趋势名。　ＰｅｎＮｕｍ　　代表笔号的整型变量或值。（１到８　）　

ＶａｌＴｙｐｅ＿Ｔｅｘｔ　　表明返回值类型的字符串。可以是以下字符串之一。　＂ＡｖｅｒａｇｅＶａｌｕ整个趋势的平均值。　ｅ＂　　

＂ＭａｘＶａｌｕｅ＂　　整个趋势的最大值。　＂ＭｉｎＶａｌｕｅ＂　　整个趋势的最小值。　

此函数返回一内存实型变量，它代表按给出类型算出的值。　例如：　

下面的语句得到趋势　Ｔｒｅｎｄ１　的　Ｐｅｎ２　所取得数据的最大值。算出的值存到内存实型变量ＬｅｆｔＨｅｍｉｓｐｈｅｒｅＳＤ中：　

　ＬｅｆｔＨｅｍｉｓｐｈｅｒｅＳＤ＝ＨＴＧｅｔＶａｌｕｅ（Ｔｒｅｎｄ１，２　，　＂ＭａｘＶａｌｕｅ＂）；　

ＨＴＧｅｔＶａｌｕｅＡｔＳｃｏｏｔｅｒ　

此函数返回一个样本在指定的指示器位置、趋势和笔号所要求的类型的的值。调用格式：　

ＲｅａｌＲｅｓｕｌｔ＝ＨＴＧｅｔＶａｌｕｅＡｔＳｃｏｏｔｅｒ（Ｈｉｓｔ＿Ｔａｇ，ＳｃｏｏｔＮｕｍ，　ＰｅｎＮｕｍ，　ＶａｌＴｙｐｅ＿Ｔｅｘｔ）；　

北京亚控自动化软件科技有限公司

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

描述　

历史趋势变量，代表趋势名。　

代表左或右指示器的整数（１＝左指示器，２＝右指示器）。　

ＰｅｎＮｕｍ　　代表笔号的整型变量或值。（１到８）　

ＶａｌＴｙｐｅ＿Ｔｅｘｔ　代表返回值类型的字符串，可以为以下字符串之一：　＂Ｖａｌｕｅ＂　取得在指示器位置处的值。　＂Ｖａｌｉｄ＂　判断取得的值是否有效。返回值为０表示取得的　

值无效，为１表示有效。　

若是“Ｖａｌｕｅ”类型，则返回模拟值。若是“Ｖａｌｉｄ”类型，则返回离散值。　例如：　

采集趋势曲线Ｔｒｅｎｄ１的笔Ｐｅｎ３在右指示器的当前值。若此值有效，则在内存离散变量ＶａｌｉｄＦｌａｇ中存入１，无效，则存入０：　

ＶａｌｉｄＦｌａｇ＝ＨＴＧｅｔＶａｌｕｅＡｔＳｃｏｏｔｅｒ（Ｔｒｅｎｄ１，２，３　，　＂Ｖａｌｉｄ＂）；　

参数　

Ｈｉｓｔ＿Ｔａｇ　　ＳｃｏｏｔＮｕｍ　　

ＨＴＧｅｔＶａｌｕｅＡｔＺｏｎｅ　

此函数返回一包含在某一趋势指定笔的左右指示器之间的数据中所要求类型的值。调用格式：　

ＲｅａｌＲｅｓｕｌｔ＝ＨＴＧｅｔＶａｌｕｅＡｔＺｏｎｅ（Ｈｉｓｔ＿Ｔａｇ，ＰｅｎＮｕｍ，　ＶａｌＴｙｐｅ＿Ｔｅｘｔ　　）；　

参数　　　　　　　　　　　　　　　　　　　　　　描述　Ｈｉｓｔ＿Ｔａｇ　历史趋势变量，代表趋势名。　ＰｅｎＮｕｍ　代表笔号的整型变量或值。（１到８）　ＶａｌＴｙｐｅ＿Ｔｅｘｔ　表明要返回值的类型的字符串，可以是以下３个字

符串之一：　

＂ＡｖｅｒａｇｅＶａｌｕｅ左右指示器间区域上的平均值。　＂　

＂ＭａｘＶａｌｕｅ＂　　左右指示器间区域上的最大值。　＂ＭｉｎＶａｌｕｅ＂　　左右指示器间区域上的最小值。　此函数直接使用运行数据库的趋势变量的．ＳｃｏｏｔｅｒＰｏｓＬｅｆｔ和．ＳｃｏｏｔｅｒＰｏｓＲｉｇｈｔ域来确定区域边界，并返回计算值。　

北京亚控自动化软件科技有限公司

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

例如：　

取得趋势曲线“Ｔｒｅｎｄ１”的　Ｐｅｎ１代表的变量左右指示器之间的平均值，并把结果存入内存实型变量　ＡｖｇＶａｌｕｅ　中。调用函数　

ＡｖｇＶａｌｕｅ＝ＨＴＧｅｔＶａｌｕｅＡｔＺｏｎｅ（Ｔｒｅｎｄ１，　１，　＂ＡｖｅｒａｇｅＶａｌｕｅ＂）；　

ＨＴＳｃｒｏｌｌＬｅｆｔ　

此函数将趋势曲线的起始时间左移（提前）给定的百分比值。百分比是相对于趋势曲线的时间轴长度。移动后时间轴的长度保持不变。调用格式：　

ＨＴＳｃｒｏｌｌＬｅｆｔ（Ｈｉｓｔ＿Ｔａｇ，Ｐｅｒｃｅｎｔ）；　

参数　　　　　　　　　描述　

Ｈｉｓｔ＿Ｔａｇ　　　　历史趋势变量，代表趋势名。　

Ｐｅｒｃｅｎｔ　　　　　　实数，代表图表要滚动的百分比（０．０到１００．０）。　例如：　

将趋势曲线Ｔｒｅｎｄ１的时间轴向左滚动（提前）１０％，调用函数　ＨＴＳｃｒｏｌｌＬｅｆｔ（Ｔｒｅｎｄ１，１０．０）；　

若当前显示起始于下午　１２：００：００　，而且显示宽度为６０秒。在函数执行后，新的趋势曲线将起始于上午　１１：５９：５４。　

ＨＴＳｃｒｏｌｌＲｉｇｈｔ　

此函数将趋势曲线的起始时间右移给定的百分比值。百分比是相对于趋势曲线的时间轴长度。移动后时间轴的长度保持不变。调用格式：　

ＨＴＳｃｒｏｌｌＲｉｇｈｔ（Ｈｉｓｔ＿Ｔａｇ，Ｐｅｒｃｅｎｔ）；　

参数　　　　　描述　Ｈｉｓｔ＿Ｔａｇ　　　历史趋势变量，代表趋势名。　Ｐｅｒｃｅｎｔ　　实数，代表图表要滚动的百分比（０．０到１００．０）。　例如：　

将趋势曲线Ｔｒｅｎｄ１的间轴范围向右滚动　２０％。调用函数　ＨＴＳｃｒｏｌｌＲｉｇｈｔ（Ｔｒｅｎｄ１，２０．０）；　

若当前显示起始于下午　１２：００：００，而且显示宽度为６０秒，则新的趋势将起始于下午　１２：００：１２　（在函数执行后）。　

北京亚控自动化软件科技有限公司

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

３　　　　　　返回当前内存中空闲空间字节数　

４　　　　　　返回当前正在运行的任务数。　Ｔｒｉｇｇｅｒ　　每当　Ｔｒｉｇｇｅｒ　值改变时，执行ＩｎｆｏＲｅｓｏｕｒｃｅ（）　函数。Ｔｒｉｇｇｅｒ　可为任一变量名（不受系统变量限制）。　

由整数　ＲｅｓｏｕｒｃｅＴｙｐｅ　指定的特定系统资源信息存放在　ＩｎｔｅｇｅｒＲｅｓｕｌｔ　中。　例如：　

下面的语句每分钟执行一次并返回当前值：　ＩｎｆｏＲｅｓｏｕｒｃｅ（１，　￥分）　将返回５４｛空闲百分比｝　ＩｎｆｏＲｅｓｏｕｒｃｅ（２，　￥分）　将返回３６｛空闲百分比｝　ＩｎｆｏＲｅｓｏｕｒｃｅ（３，　￥分）　将返回１１５２４０９３｛字节数｝　ＩｎｆｏＲｅｓｏｕｒｃｅ（４，　￥分）　将返回１４｛任务数｝　注意：　　　在ＷＩＮ　ＮＴ　下返回ＧＤＩ和ＵＳＥＲ的资源可用空闲空间的百分比是一样的，与ＷＩＮ　ＮＴ系统有关。　

Ｉｎｔ　

此函数返回小于等于指定数值的最大整数。调用格式：　

ＩｎｔｅｇｅｒＲｅｓｕｌｔ＝Ｉｎｔ（Ｎｕｍｂｅｒ）；　

参数　　　　　描述　

Ｎｕｍｂｅｒ　　　　　任一数字或者组态王的实型或整型变量名。　例如：　

Ｉｎｔ（４．７）　将返回　４　Ｉｎｔ（－４．７）　将返回　－５　

ＩｓＰｌａｙＳｏｕｎｄＥｎｄ　

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

ＩｓＰｌａｙＳｏｕｎｄＥｎｄ（）　此函数无参数。　

ｌｉｓｔＬｏａｄＬｉｓｔ（）　

北京亚控自动化软件科技有限公司

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

此函数用于将ＣＳＶ文件Ｆｉｌｅｎａｍｅ中的列表项调入指定的列表框控件ＣｏｎｔｒｏｌＮａｍｅ中，并替换列表框中的原有列表项。列表框中只显示列表项的成员名称（字符串信息），而不显示相关的数据值。　语法格式使用如下：　

ｌｉｓｔＬｏａｄＬｉｓｔ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，＂Ｆｉｌｅｎａｍｅ＂）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。　

Ｆｉｌｅｎａｍｅ：ｃｓｖ文件，用写字板程序进行编辑，用以存放列表框中要显示的列表项。　例如：　

ｌｉｓｔＬｏａｄＬｉｓｔ（＂组合框信息＂，＂ｃ：＼组态王＼ｌｉｓｔ．ｃｓｖ＂）；　

此语句将指定的文件ｌｉｓｔ．ｃｓｖ调入名为组合框信息的列表框中并显示出来。　注：　

如果没有给出ｃｓｖ文件所在的完整路径，则该函数就从组态王所在的路径下寻找指定的文件。　

ｌｉｓｔＳａｖｅＬｉｓｔ（）　

此函数用于将列表框控件ＣｏｎｔｒｏｌＮａｍｅ中的列表项信息存入ＣＳＶ文件Ｆｉｌｅｎａｍｅ中。如果该文件不存在，则直接创建。　语法格式使用如下：　

ｌｉｓｔＳａｖｅＬｉｓｔ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，＂Ｆｉｌｅｎａｍｅ＂）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。　

Ｆｉｌｅｎａｍｅ：ＣＳＶ文件，按一定格式用以存放列表框中的列表项。　例如：　

ｌｉｓｔＳａｖｅＬｉｓｔ（＂组合框信息＂，＂ｃ：＼组态王＼ｌｉｓｔ．ｃｓｖ＂）；　

此语句将组合框信息列表框中的列表项存入到文件ｃ：＼组态王＼ｌｉｓｔ．ｃｓｖ中。　注：　

如果没有给出ＣＳＶ文件所在的完整路径，则该函数在组态王所

北京亚控自动化软件科技有限公司

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

在的路径下创建该文件。　

ｌｉｓｔＡｄｄＩｔｅｍ（）　

此函数将给定的列表项字符串信息ＭｅｓｓａｇｅＴａｇ增加到指定的列表框

控件ＣｏｎｔｒｏｌＮａｍｅ中并显示出来。组态王将增加的字符串信息作为列表框中的一个成员项　Ｉｔｅｍ，并自动给这个成员项定义一个索引号ＩｔｅｍＩｎｄｅｘ，索引号ＩｔｅｍＩｎｄｅｘ从１开始由小到大自动加１。　语法格式使用如下：　

ｌｉｓｔＡｄｄＩｔｅｍ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，＂ＭｅｓｓａｇｅＴａｇ＂）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。　

ＭｅｓｓａｇｅＴａｇ：字符串值，表示增加到指定列表框控件的成员项字符串信息。　例如：　

ｌｉｓｔＡｄｄＩｔｅｍ（＂报警信息＂，＂温度报警＂）；　

此语句将“温度报警”　字符串信息增加到列表框控件报警信息中并显示出来。　

ｌｉｓｔＡｄｄＩｔｅｍ（＂配方信息＂，＂巧克力面包＂）；　

此语句将“巧克力香型面包”　字符串信息增加到列表框控件配方信息中并显示出来。　　

ｌｉｓｔＣｌｅａｒ（）　

此函数将清除指定列表框控件ＣｏｎｔｒｏｌＮａｍｅ中的所有列表成员项。　语法格式使用如下：　

ｌｉｓｔＣｌｅａｒ（＂ＣｏｎｔｒｏｌＮａｍｅ＂）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。　例如：　

ｌｉｓｔＣｌｅａｒ（＂报警信息＂）；　

此语句将清除报警信息列表框中的所有列表成员项。　

北京亚控自动化软件科技有限公司

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

ｌｉｓｔＤｅｌｅｔｅＩｔｅｍ（）　

此函数将在指定的列表框控件ＣｏｎｔｒｏｌＮａｍｅ中删除索引号为ＩｔｅｍＩｎｄｅｘ的成员项。　语法格式使用如下：　

ｌｉｓｔＤｅｌｅｔｅＩｔｅｍ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，ＩｔｅｍＩｎｄｅｘ）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。　

ＩｔｅｍＩｎｄｅｘ：列表框控件中的成员项索引号，通常为数字常量或整型变量。　例如：　

ｌｉｓｔＤｅｌｅｔｅＩｔｅｍ（＂报警信息＂，１）；　

此语句将在报警信息列表框中删除索引号为１的成员项。　ｌｉｓｔＤｅｌｅｔｅＩｔｅｍ（＂配方信息＂，５）；　

此语句将在配方信息列表框中删除索引号为５的成员项。　

ｌｉｓｔＤｅｌｅｔｅＳｅｌｅｃｔｉｏｎ（）　

此函数将删除列表框控件ＣｏｎｔｒｏｌＮａｍｅ中当前选定的成员项。　语法格式使用如下：　

ｌｉｓｔＤｅｌｅｔｅＳｅｌｅｃｔｉｏｎ（＂ＣｏｎｔｒｏｌＮａｍｅ＂）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。　例如：　

ｌｉｓｔＤｅｌｅｔｅＳｅｌｅｃｔｉｏｎ（＂报警信息＂）；　

此语句将在报警信息列表框中删除当前选定的成员项。　

ｌｉｓｔＦｉｎｄＩｔｅｍ（）　

此函数用于查找与给定的成员字符串信息ＭｅｓｓａｇｅＴａｇ相对应的索引号，并送给整型变量ＩｎｄｅｘＴａｇ。　语法格式使用如下：　

ｌｉｓｔＦｉｎｄＩｔｅｍ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，＂ＭｅｓｓａｇｅＴａｇ＂，ＩｎｄｅｘＴａｇ）；　参数说明：　

北京亚控自动化软件科技有限公司

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

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英

文名。　

ＭｅｓｓａｇｅＴａｇ：字符串值，表示列表成员项字符串信息。　

ＩｎｄｅｘＴａｇ：整型变量，用以存放与给定的成员字符串信息ＭｅｓｓａｇｅＴａｇ相对应的索引号　例如：　

以ＣＳＶ文件ｌｉｓｔ．ｃｓｖ中存放的列表项信息为例如，　ｌｉｓｔＦｉｎｄＩｔｅｍ（＂组合框信息＂，＂温度＂，ＩｎｄｅｘＴａｇ）；　

此语句将“温度”　字符串信息相对应的索引号送给整型变量ＩｎｄｅｘＴａｇ。在此例如中ＩｎｄｅｘＴａｇ＝１。　　

ｌｉｓｔＧｅｔＩｔｅｍ（）　

此函数用于获取索引号为ＩｔｅｍＩｎｄｅｘ的列表项成员字符串信息，并送给字符串变量ＳｔｒｉｎｇＴａｇ。　语法格式使用如下：　

ｌｉｓｔＧｅｔＩｔｅｍ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，ＩｔｅｍＩｎｄｅｘ，ＳｔｒｉｎｇＴａｇ）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。　

ＩｔｅｍＩｎｄｅｘ：数值常量或变量，表示列表索引号。　

ＳｔｒｉｎｇＴａｇ：字符串变量，用以存放索引号为ＩｔｅｍＩｎｄｅｘ的列表项成员字符串信息　例如：　

以ＣＳＶ文件ｌｉｓｔ．ｃｓｖ中存放的列表项信息为例如，　ｌｉｓｔＧｅｔＩｔｅｍ（＂组合框信息＂，２，ＳｔｒｉｎｇＴａｇ）；　

此语句将索引号为２的列表项成员字符串信息字符串变量ＳｔｒｉｎｇＴａｇ。在此例如中，ＳｔｒｉｎｇＴａｇ＝压力。　

ｌｉｓｔＧｅｔＩｔｅｍＤａｔａ（）　

此函数用于获取索引号为ＩｔｅｍＩｎｄｅｘ的列表项中的数据值，并送给整型变量ＮｕｍｂｅｒＴａｇ。　语法格式使用如下：　

ｌｉｓｔＧｅｔＩｔｅｍＤａｔａ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，ＩｔｅｍＩｎｄｅｘ，ＮｕｍｂｅｒＴａｇ　）；　

北京亚控自动化软件科技有限公司

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

参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。　

ＩｔｅｍＩｎｄｅｘ：数值常量或变量，表示列表索引号。　

ＮｕｍｂｅｒＴａｇ：整型变量，用以存放索引号为ＩｔｅｍＩｎｄｅｘ的列表项的数据值。　例如：　

以ＣＳＶ文件ｌｉｓｔ．ｃｓｖ中存放的列表项信息为例如，　ｌｉｓｔＧｅｔＩｔｅｍＤａｔａ（＂组合框信息＂，２，　ＮｕｍｂｅｒＴａｇ）；　

此语句将索引号为２的列表项的数据值送给变量ＮｕｍｂｅｒＴａｇ。在此例如中，ＮｕｍｂｅｒＴａｇ＝４０。　

ｌｉｓｔＩｎｓｅｒｔＩｔｅｍ（）　

此函数将字符串信息ＳｔｒｉｎｇＴａｇ插入到列表项索引号ＩｔｅｍＩｎｄｅｘ所指示的位置。如果ＩｔｅｍＩｎｄｅｘ＝－１，则字符串信息ＳｔｒｉｎｇＴａｇ被插入到列表项的最尾端。　语法格式使用如下：　

ｌｉｓｔＩｎｓｅｒｔＩｔｅｍ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，ＩｔｅｍＩｎｄｅｘ，　＂ＳｔｒｉｎｇＴａｇ＂　）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。　

ＩｔｅｍＩｎｄｅｘ：数值常量或变量，表示列表索引号。　ＳｔｒｉｎｇＴａｇ：字符串常量。　例如：　

ｌｉｓｔＩｎｓｅｒｔＩｔｅｍ（＂组合框信息＂，２，“炉温”）；　

此语句将字符串信息“炉温”插入到索引号２所指示的位置。　　

ｌｉｓｔＳｅｔＩｔｅｍＤａｔａ（）；　

此函数用于将变量Ｎｕｍｂｅｒ的值设置索引号为ＩｔｅｍＩｎｄｅｘ的列表项中。　语法格式使用如下：　

ｌｉｓｔＳｅｔＩｔｅｍＤａｔａ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，ＩｔｅｍＩｎｄｅｘ，　Ｎｕｍｂｅｒ　）；　参数说明：　

北京亚控自动化软件科技有限公司

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

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英

文名。　

ＩｔｅｍＩｎｄｅｘ：数值常量或变量，表示列表索引号。　Ｎｕｍｂｅｒ：整型变量，用以存放数据值。　例如：　

ｌｉｓｔＳｅｔＩｔｅｍＤａｔａ（＂组合框信息＂，２，Ｎｕｍｂｅｒ）；　

此语句将变量Ｎｕｍｂｅｒ中的值设置到索引号为２的列表项。　

ＬｉｓｔＬｏａｄＦｉｌｅＮａｍｅ（）；　

此函数将字符串常量ＳｔｒｉｎｇＴａｇ指示的文件名显示在列表框中。　

ＬｉｓｔＬｏａｄＦｉｌｅＮａｍｅ（“ＣｏｎｔｒｏｌＮａｍｅ”，　“ＳｔｒｉｎｇＴａｇ”）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：　工程人员定义的列表框控件名称，可以为中文名或英文名。　

ＳｔｒｉｎｇＴａｇ：　字符串常量，工程人员要查询的文件，支持通配符。　例如：　

ＬｉｓｔＬｏａｄＦｉｌｅＮａｍｅ（“报警文件列表”，　“ｃ：＼ａｐｐｄｉｒ＼ａｌａｒｍ＼＊．ａｌｇ”）；　

此语句将ｃ：＼ａｐｐｄｉｒ＼ａｌａｒｍ目录下的后缀为．ａｌｇ的文件名显示在列表框中　

ＬｏａｄＴｅｘｔ（）　

此函数将指定的ＲＴＦ或ＴＸＴ格式文件调入到超级文本显示控件中加以显示。　

语法格式使用如下：　

　　　　　　　　　ＬｏａｄＴｅｘｔ（　＂ＣｏｎｔｒｏｌＮａｍｅ＂，　＂ＦｉｌｅＮａｍｅ＂，　＂．Ｔｘｔ　Ｏｒ　．Ｒｔｆ＂　）　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的超级文本显示控件名称，可以为中文名或英文名。　

ＦｉｌｅＮａｍｅ：ＲＴＦ或ＴＸＴ格式的文件，可用ＷＩＮＤＯＷＳ的写字板编写这两种格式的文件。　

．Ｔｘｔ　Ｏｒ　．Ｒｔｆ：指定文件为ＲＴＦ格式或ＴＸＴ格式。　

北京亚控自动化软件科技有限公司

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

例如：　

ＬｏａｄＴｅｘｔ（＂ｈｙｐｅｒｔｅｘｔ１＂，＂Ｄ：＼Ｔｅｓｔ＼ｒｅｃｉｐｅ＼ｈｔ１．ｒｔｆ＂，　＂．Ｒｔｆ＂）；　

此语句把ＲＴＦ格式的文件ｈｔ１．ｒｔｆ调入到名称为ｈｙｐｅｒｔｅｘｔ１的超级文本显示控件中加以显示。　　

ＬｏｇＥ　

此函数返回对数函数ｌｏｇｅｘ的计算结果，　Ｘ为变量值，　调用格式：　

Ｌｏｇ（变量值）；　例如：　

Ｌｏｇ（１００）返回ｌｏｇｅ１００计算值４．６０５　Ｌｏｇ（１）返回ｌｏｇｅ１计算值０　　

ＬｏｇＮ　

此函数返回以ｎ为底的ｘ的对数。以１为底的对数没有定义。调用格式：　

Ｒｅｓｕｌｔ＝ＬｏｇＮ（Ｎｕｍｂｅｒ，Ｂａｓｅ）；　

参数　　　　　　　描述　

Ｎｕｍｂｅｒ　　　　　　　任一数字或者组态王的实型或整型变量名。　Ｂａｓｅ　　　　　　　做底的整数。　例如：　

ＬｏｇＮ（８，　３）　将返回　１．８９２７９．．．　ＬｏｇＮ（３，　７）　将返回　０．５６４．．．　

ＬｏｇＯｆｆ　

此函数用于在ＴＯＵＣＨＶＥＷ中退出登录。调用格式：　

ＬｏｇＯｆｆ（　）；　

参数　　　　　　　无　　

ＬｏｇＯｎ　

此函数用于在ＴｏｕｃｈＶｅｗ中登录。调用格式：　

ＬｏｇＯｎ（　）；　参数　　　　　　　无　

北京亚控自动化软件科技有限公司

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

例如：　

为画面上某个按钮建立命令语言连接：　ＬｏｇＯｎ（　）；　

画面程序运行时单击此按钮，弹出“登录”对话框：　　

工程人员在此对话框中输入用户名和口令，以获得操作权限。　

ＬｏｇＯｐｅｒａｔｅＳｔｒｉｎｇ　

此函数用于记录操作员的操作过程时，在记录文件（＊．ＡＬＧ）中加入描述信息。调用格式：　

ＬｏｇＯｐｅｒａｔｅＳｔｒｉｎｇ（　ｓｔｒｉｎｇ　）；　参数　　　　　　　描述　

ｓｔｒｉｎｇ　　　　　　字符串或字符串变量　例如：　

ＬｏｇＯｐｅｒａｔｅＳｔｒｉｎｇ（　“系统启动”　）；　　　

ＬｏｇＯｐｅｒａｔｅＳｔｒｉｎｇ（　ＳｔａｒｔＳｔｒｉｎｇ　）；　　　ＳｔａｒｔＳｔｒｉｎｇ为内存字符串变量。　

只有当“操作信息记录格式”对话框中“描述”项被选中时，此函数才起作用。（参见１６．４节和３．３．６节相关内容。）　

ＬｏｇＳｔｒｉｎｇ　

此函数写一个工程人员自定义消息到组态王。调用格式：　ＬｏｇＳｔｒｉｎｇ（Ｍｅｓｓａｇｅ）；　

参数　　　　　描述　

Ｍｅｓｓａｇｅ　　要记录到组态王的字符串。　例如：　

ＬｏｇＳｔｒｉｎｇ（＂Ｒｅｐｏｒｔ　Ｓｃｒｉｐｔ　ｉｓ　Ｒｕｎｎｉｎｇ＂）；　

北京亚控自动化软件科技有限公司

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

Ｍａｘ　

此函数用于求得两个数中较大的一个数。　例如：　

ＭａｘＶａｌｕｅ　＝　Ｍａｘ（Ｍａｘ（ｖａｒ１，ｖａｒ２），　ｖａｒ３　）　

此函数返回值ＭａｘＶａｌｕｅ为ｖａｒ１、ｖａｒ２、ｖａｒ３中最大的数。　

Ｍｉｎ　

此函数用于求得两个数中较小的一个数。　例如：　

ＭｉｎＶａｌｕｅ＝Ｍｉｎ（Ｍｉｎ（ｖａｒ１，ｖａｒ２），ｖａｒ３）　

此函数返回值ＭｉｎＶａｌｕｅ为ｖａｒ１、ｖａｒ２、ｖａｒ３中最小的数。　

ＰａｇｅＤｏｗｎ　

用于报警窗口信息的向前翻页显示。调用形式：　

ＰａｇｅＤｏｗｎ（报警窗口名，翻页行数）；　例如：　

ＰａｇｅＤｏｗｎ（全厂历史报警记录窗口，７）；　该调用将“全厂历史报警记录窗口”的报警记录向下翻７行（如果有足够报警记录的话）．　

ＰａｇｅＵｐ　

用于报警窗口信息的向后翻页显示。调用格式：　

Ｐａｇｅｕｐ（报警窗口名，翻页行数）；　例如：　

ＰａｇｅＵｐ（全厂历史报警记录窗口，７）；　该调用将“全厂历史报警记录窗口”的报警记录向上翻７行（如果有足够报警记录的话）．　

ＰＩ　

此函数返回圆周率的值。调用格式：　

ＲｅａｌＲｅｓｕｌｔ＝ＰＩ（）；　例如：　

北京亚控自动化软件科技有限公司

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

ＰＩ（　）将返回　３．１４１５９２６．．．　

ＰｌａｙＡｖｉ　

此函数用于播放动画，动画为．ａｖｉ文件。　

调用格式：　

ＰｌａｙＡｖｉ（ＣｏｎｔｒｏｌＮａｍｅ，ＡｖｉＮａｍｅ，Ｆｌａｇｓ）；　参数及其描述　

ＣｏｎｔｒｏｌＮａｍｅ：　用于播放播放ＡＶＩ动画的控件的名称。　ＡｖｉＮａｍｅ　：代表要播放的动画文件的字符串或字符串变量。　Ｆｌａｇｓ　　　　　　：可为下述之一：　

　　　０　　　　　　　　停止播放ＡＶＩ动画　　　　　　１　　　　　　　　播放一遍ＡＶＩ动画　

　　　２　　　　　　　　连续播放ＡＶＩ动画，直到接收到停止播放的信息为止　例如：　

ＰｌａｙＡｖｉ（　＂ｃｔｌ＿ａｖｉ＂，＂ｃ：＼ｄｅｍｏ＼Ｗｉｎｎｅｒ．ａｖｉ＂，１　）；　此函数的功能是在名称为“ｃｔｌ＿ａｖｉ”的控件中播放Ｗｉｎｎｅｒ．ａｖｉ中存放的动画，只播放一次。画面停止在动画的最后。　　

ＰｌａｙＳｏｕｎｄ　

此函数通过　Ｗｉｎｄｏｗｓ　的声音设备（若已安装）播放声音，声音为ｗａｖ文件。调用格式：　

ＰｌａｙＳｏｕｎｄ（ＳｏｕｎｄＮａｍｅ，Ｆｌａｇｓ）；　

参数　　　　　　　　　　　描述　ＳｏｕｎｄＮａｍｅ　　　　　　　代表要播放的声音文件的字符串或字符串变量。　Ｆｌａｇｓ　　　　　　　　　　　Ｆｌａｇｓ　可为下述之一：　０　　　　　　　　　停止播放声音　１　　　　　　　　　同步播放声音　２　　　　　　　　　异步播放声音　３　重复播放声音直到下次调用ＰｌａｙＳｏｕｎｄ（）　函数为止。　４　蜂鸣器报警　例如：　

ＰｌａｙＳｏｕｎｄ　（＂ｃ：＼ｈｏｒｎｓ．ｗａｖ＂，２）；　

声音需要在安装了ｗａｖｅ形式音频设备驱动器上播放。声音文

北京亚控自动化软件科技有限公司

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

件目录的查找按以下顺序：当前目录；Ｗｉｎｄｏｗｓ目录；Ｗｉｎｄｏｗｓ系统目录；在路径中列出的目录。若缺省的声音文件或系统缺省的声音文件找不到，则不播放声音。　ＰｌａｙＳｏｕｎｄ　（＂＂，４）；　蜂鸣器报警。　

Ｐｏｗ　

此函数求得一模拟值或模拟变量的任意次幂。调用格式：　

Ｒｅｓｕｌｔ＝Ｐｏｗ（ｘ，　ｙ）；　

参数　　　　　描述　ｘ　　　底数　ｙ　　　指数　

返回值为ｘ的ｙ次幂。　例如：　

Ｒｅｓｕｌｔ＝Ｐｏｗ（２，　３）；　　函数调用后Ｒｅｓｕｌｔ＝８．０　

ＰｒｉｎｔＷｉｎｄｏｗ　

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

ＰｒｉｎｔＷｉｎｄｏｗ（　＂Ｗｉｎｄｏｗ＂，　ｘＳｃａｌｅ，　ｙＳｃａｌｅ　，　ｏｐｔｉｏｎ，　ｘＳｔａｒｔ，　ｙＳｔａｒｔ）；　

参数　　　　　　　　　　　　　描述　

Ｗｉｎｄｏｗ　　　　　　　要打印的窗口名。　ｘＳｃａｌｅ　打印输出的宽度占此页总宽的百分比。此参数可以

取０，以使用缺省最大的纵横比或者取一指定的宽度。　

ＹＳｃａｌｅ　　　　　　　　　打印输出的高度占此页总高度的百分比。此参数可

以取０，以使用缺省最大的纵横比或者取一指定的高度。　

Ｏｐｔｉｏｎｓ　离散值：０或１，仅在　Ｗｉｄｔｈ　和　Ｈｅｉｇｈｔ　都为　０　时

使用。若　Ｏｐｔｉｏｎｓ　为１窗口在最大纵横比下以窗口尺寸的整数倍数打印。若　Ｏｐｔｉｏｎｓ　为　０，以适于此页的最大纵横比打印。若窗口包含位图，置　Ｏｐｔｉｏｎｓ　为　１，以免位图被拉长。　

北京亚控自动化软件科技有限公司

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

ｘＳｔａｒｔ　　　　　　　要打印的窗口横向空白长度的百分比。　

ＹＳｔａｒｔ　　　　要打印的窗口纵向空白长度的百分比。　　

许多报表可通过使用此函数进行排队打印。字体原样打印，对象则被位图化而且以位图的形式打印。白色背景并且仅仅包含文字的窗口可以很快打印出来。若打印彩色背景并且包含许多对象的窗口将花费较长的时间。　

若要确保窗口中的文本能被正确打印，建议将所有要被打印的窗口中的文体域设置为“Ｔｒｕｅ　Ｔｙｐｅ”字体。　

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

下图显示了ｘＳｃａｌｅ，ＹＳｃａｌｅ，ｘＳｔａｒｔ，ｙＳｔａｒｔ之间的关系：　　

ｘＳｃａｌＹＳｃａｌｅ ｙＳｔａｒｔ ｘＳｔａｒ　　

例如：　

每天上午　８：３０　打印三页报表，使用命令语言：　ｉｆ　（　￥时　＝＝　８　＆＆　￥分　＝＝　３０　）　｛　

　ＰｒｉｎｔＷｉｎｄｏｗ（＂１ｓｔ　Ｓｈｉｆｔ　Ｓｕｍｍａｒｙ＂，０，０，０，１０，１０）；　

北京亚控自动化软件科技有限公司

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

　ＰｒｉｎｔＷｉｎｄｏｗ（＂２ｎｄ　Ｓｈｉｆｔ　Ｓｕｍｍａｒｙ＂，０，０，０，１０，１０）；　　ＰｒｉｎｔＷｉｎｄｏｗ（＂３ｒｄ　Ｓｈｉｆｔ　Ｓｕｍｍａｒｙ＂，０，０，０，１０，１０）；　｝　

命令语言应用程序的执行优先于此函数的执行。若命令语言应用程序频繁运行的话，例如如每　２００　毫秒运行一次，窗口的打印可能要多花费些时间。　

ｐｖＡｄｄＮｅｗＲｅａｌＰｔ（）　

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

ｐｖＡｄｄＮｅｗＲｅａｌＰｔ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，ｔｉｍｅＯｆｆｓｅｔ，Ｖａｌｕｅ，　＂ｃｏｍｍｅｎｔＴａｇ＂　）；　参数说明：　

ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的温控曲线控件名称，可以为中文名或英文名。　

ｔｉｍｅＯｆｆｓｅｔ：相对前一采样点的时间偏移量（即距前一值的时间间隔值），第一个值取０。　

Ｖａｌｕｅ：温度的采样值，实型数据，此变量通常为组态王数据库中定义的Ｉ／Ｏ实数变量。　

ｃｏｍｍｅｎｔＴａｇ：注释性字符串，也可以是字符串变量，当游标移动到此点时，给出提示性信息。　例如１：　

ｐｖＡｄｄＮｅｗＲｅａｌＰｔ（　＂反应罐温控曲线＂，　１，　３８，　＂温度值为３８度＂　）；　

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

设反应罐实时温度是组态王数据库中定义的一个Ｉ／Ｏ实数变量，接收从下位机中送来的温度值，ＴｉｍｅＳｔｒｉｎｇ为组态王数据库中定义的一个字符串变量。　

ＴｉｍｅＳｔｒｉｎｇ＝ＳｔｒＦｒｏｍＩｎｔ（￥时）＋　＂：＂＋　ＳｔｒＦｒｏｍＩｎｔ（￥分）＋　＂：＂＋　ＳｔｒＦｒｏｍＩｎｔ（￥秒）　

北京亚控自动化软件科技有限公司

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

ｐｖＡｄｄＮｅｗＲｅａｌＰｔ（　＂反应罐温控曲线＂，　１０，　反应罐实时温度，　

ＴｉｍｅＳｔｒｉｎｇ　）；　

此语句在反应罐温控曲线控件中给出变量反应罐实时温度的采样实时值。此采样实时值距前一值的时间间隔值为１０，当游标移动到此点时，给出ＴｉｍｅＳｔｒｉｎｇ中的提示性信息。　　　

A 注意：　　　　　设定曲线将根据实时曲线第一点的位置而变。 　　

例如：　

实时曲线第一点的位置为：（用一按钮添加实时曲线第一点）　ｐｖＡｄｄＮｅｗＲｅａｌＰｔ（　＂反应罐温控曲线＂，　１０，　２０，　ＴｉｍｅＳｔｒｉｎｇ　）；　

图中为一设定曲线，按下按钮后，如下图示：　　

北京亚控自动化软件科技有限公司

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