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

此语句将指定的文件list.csv 调入名为组合框信息的列表 框中并显示出来。 注：

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

此函数用于将列表框控件ControlName 中的列表项信息存入CSV 文 件Filename 中。如果该文件不存在，则直接创建。语法格式使用如 下：

listSaveList(\参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。

Filename：CSV 文件，按一定格式用以存放列表框中的列表项。 例如：

listSaveList(\组合框信息\组态王\\list.csv\此语句将组合框信息列表框中的列表项存入到文件c:\\组态 王\\list.csv 中。 注：

如果没有给出CSV 文件所在的完整路径，则该函数在组态王 所在的路径下创建该文件。 listAddItem

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

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

listAddItem(\参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。

MessageTag：字符串值，表示增加到指定列表框控件的成员项字符 串信息。 例如：

listAddItem(\报警信息\温度报警\

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

listAddItem(\配方信息\巧克力面包\

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

此函数将清除指定列表框控件ControlName 中的所有列表成员项。 语法格式如下：

listClear(\参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。 例如：

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

listClear(\报警信息\

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

此函数将在指定的列表框控件ControlName 中删除索引号为 ItemIndex 的成员项。语法格式如下： listDeleteItem(\参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。

ItemIndex：列表框控件中的成员项索引号，通常为数字常量或整型 变量。 例如：

listDeleteItem(\报警信息\

此语句将在报警信息列表框中删除索引号为1 的成员项。 listDeleteItem(\配方信息\

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

此函数将删除列表框控件ControlName 中当前选定的成员项。语法 格式如下：

listDeleteSelection(\参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。 例如：

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

listDeleteSelection(\报警信息\

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

此函数用于查找与给定的成员字符串信息MessageTag 相对应的索 引号，并送给整型变量IndexTag。语法格式如下： listFindItem(\参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。

MessageTag：字符串值，表示列表成员项字符串信息。

IndexTag：整型变量，用以存放与给定的成员字符串信息MessageTag 相对应的索引号. 例如：

以CSV 文件list.csv 中存放的列表项信息为例如， listFindItem(\组合框信息\温度\，IndexTag);

此语句将“温度” 字符串信息相对应的索引号送给整型变量 IndexTag。在此例如中IndexTag=1。 listGetItem

此函数用于获取索引号为ItemIndex 的列表项成员字符串信息，并 送给字符串变量StringTag。语法格式如下： listGetItem(\

参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。

ItemIndex：数值常量或变量，表示列表索引号。 组态王命令语言函数速查手册 北京亚控科技发展有限公司 49

StringTag：字符串变量，用以存放索引号为ItemIndex 的列表项成 员字符串信息。 例如：

以CSV 文件list.csv 中存放的列表项信息为例如， listGetItem(\组合框信息\，StringTag);

此语句将索引号为2 的列表项成员字符串信息字符串变量 StringTag。在此例如中，StringTag=压力。 listGetItemCount

此函数用于获取指定控件“ControlName”中列表项的数目。语法格 式如下：

listGetItemCount(\参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。 例如：

Count=listGetItemCount(\

将列表框控件“list”中列表项的数目赋给变量Count。 ListGetCurSel

此函数用于获取指定控件“ControlName”当前选中列表项的ID 号 (从0 开始)，返回值为-1 说明当前控件没有选中项目。语法格式如 下：

listGetCurSel(\参数说明：

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

ItemIndex=listGetCurSel(\

将列表框控件“list”中当前选中的列表项的ID 号赋给变量 ItemIndex。 ListSetCurSel

此函数用于将控件中索引号为ItemIndex 的列表项设置为当前选中 项，返回值为控件中当前选中项的索引号(从0 开始)。如果返回值 为-1，说明没有设置成功（ItemIndex 为负数或超过列表项数）。语 法格式如下：

listSetCurSel(\参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。

ItemIndex: 数值常量或变量，表示列表项索引号。 例如：

ID=listSetCurSel(\

设置列表框控件“list”当前选中项为索引号为1 的列表项。 并将当前选中列表项的索引号赋给变量ID。 listGetItemData

此函数用于获取索引号为ItemIndex 的列表项中的数据值，并送给 整型变量NumberTag。语法格式如下：

listGetItemData(\参数说明：

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

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。

ItemIndex：数值常量或变量，表示列表索引号。

NumberTag：整型变量，用以存放索引号为ItemIndex 的列表项的数 据值。 例如：

以CSV 文件list.csv 中存放的列表项信息为例如， listGetItemData(\组合框信息\

此语句将索引号为2 的列表项的数据值送给变量NumberTag。 在此例如中，NumberTag=40。 listInsertItem

此函数将字符串信息StringTag 插入到列表项索引号ItemIndex 所 指示的位置。如果ItemIndex=-1，则字符串信息StringTag 被插入 到列表项的最尾端。语法格式如下： listInsertItem(\\参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。

ItemIndex：数值常量或变量，表示列表索引号。 StringTag：字符串常量。 例如：

listInsertItem(\组合框信息\，“炉温”);

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

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

此函数用于将变量Number 的值设置索引号为ItemIndex 的列表项 中。语法格式如下：

listSetItemData(\参数说明：

ControlName：工程人员定义的列表框控件名称，可以为中文名或英 文名。

ItemIndex：数值常量或变量，表示列表索引号。 Number：整型变量，用以存放数据值。 例如：

listSetItemData(\组合框信息\，Number);

此语句将变量Number 中的值设置到索引号为2 的列表项。 ListLoadFileName

此函数将字符串*.ext 指示的文件名显示在列表框中。

ListLoadFileName(\参数说明：

CtrlName: 工程人员定义的列表框控件名称，可以为中文名或英文 名。

*.ext: 字符串常量，工程人员要查询的文件，支持通配符。 例如：

ListLoadFileName(“报警文件列表”, “c:\\appdir\\alarm\\*.al2”);

此语句将c:\\appdir\\alarm 目录下的后缀为.al2 的文件名显 示在列表框中。 LoadDriverConfig

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

根据“sDriverFilePath”中指定的参数数据库路径和文件名称及 “nRow”指定的要下载的参数的段号，此函数用于将指定控制段的一个或全部数据一次性写入控制设备中。此函数为组态王公用函数。调用格式：

LoadDriverConfig(sDriverFilePath, nRow);

参数说明：sDriverFilePath： 字符串型 指定的参数数据库路径和 文件名称

nRow： 整型 要下载的参数的段号，当nRow＝ 9999 时，下载驱动配置表中指定 的所有参数的所有数据。 返回值：整型

1 表示下载失败（此处的下载失败只指组态王读取数据错 误或驱动配置校验错误，而不是指数据写设备成功） 0 表示下载成功 -1 打开数据库文件失败 -2 驱动配置表中无记录 -3 获得控制字段名失败 -4 根据字段得到驱动信息失败 -5 为未定义 -6 为未定义 -7 为未定义 -8 为未定义

-9 驱动配置信息无参数 -10 为未定义

-11 下载点数超过限制 -12 表没有被记录

-13 非温控版不支持数据下载 -14 演示模式不支持数据下载 例如：

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

1、下载驱动配置中指定的段号为1的参数 long lRet;

String strDBPath=\数据库\\control.mdb\long nRow=1;

lRet=LoadDriverConfig（strDBPath，nRow）;

2、下载驱动配置中指定的全部参数 long lRet;

String strDBPath=\数据库\\control.mdb\lRet=LoadDriverConfig（strDBPath，9999）; LoadText

此函数将指定的RTF 或TXT 格式文件调入到超级文本显示控件中加 以显示。语法格式如下：

LoadText( \Or .Rtf\参数说明：

ControlName：工程人员定义的超级文本显示控件名称，可以为中文 名或英文名。

FileName：RTF 或TXT 格式的文件，可用WINDOWS 的写字板编写这 两种格式的文件。

.Txt Or .Rtf：指定文件为RTF 格式或TXT 格式。 例如：

LoadText(\\

此语句把RTF 格式的文件ht1.rtf 调入到名称为hypertext1 的超级文本显示控件中加以显示。 组态王命令语言函数速查手册 北京亚控科技发展有限公司 55 LogE

此函数返回对数函数loge

x 的计算结果, X 为变量值, 调用格式： LogE(变量值); 例如：

LogE(100);返回loge100 计算值4.605 LogE(1);返回loge1 计算值0 LogN

此函数返回以n 为底的x 的对数。以1 为底的对数没有定义。调用 格式：

Result=LogN(Number,Base); 参数 描述

Number 任一数字或者组态王的实型或整型变量名。 Base 做底的整数。 例如：

LogN(8, 3);将返回 1.89279... LogN(3, 7);将返回 0.564... LogOff

此函数用于在TOUCHVEW 中退出登录。调用格式： LogOff( ); 参数 无 LogOn

此函数用于在TouchVew 中登录。调用格式： 组态王命令语言函数速查手册 北京亚控科技发展有限公司 56 LogOn( ); 参数 无

例如：

为画面上某个按钮建立命令语言连接： LogOn( );

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

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

此函数写一个工程人员自定义消息到组态王，信息将被输出到组团 瓦信息窗口中。也可以使用Trace()函数实现。调用格式： LogString(String); 参数 描述

String 要记录到组态王的字符串。 例如：

LogString(\Max

此函数用于求得给定的数中最大的一个数。其参数个数为1-16 个。组态王命令语言函数速查手册 北京亚控科技发展有限公司 57

调用格式：

Max( Val1, Val2 ); 例如：

MaxValue = Max(Max(var1,var2), var3 );

此函数返回值MaxValue 为var1、var2、var3 中最大的数。 Min

此函数用于求得给定的数中最小的一个数。其参数个数为1-16 个。例如：

MinValue=Min(Min(var1,var2),var3);

此函数返回值MinValue 为var1、var2、var3 中最小的数。 ModifyTagField

此函数用于修改变量的属性值 语法格式使用如下：

ModifyTagField(\te,Hour,Minute,Second,millSecond); 参数说明：

VarName：变量名称。 Value： 变量值。 Quality：变量的质量戳。 Year：变量时间戳的年。 Month：变量时间戳的月。 Date：变量时间戳的日。 Hour：变量时间戳的时。 Minute：变量时间戳的分。 组态王命令语言函数速查手册 北京亚控科技发展有限公司 58

Second：变量时间戳的秒。 millSecond：变量时间戳的毫秒。 例如：

ModifyTagField(\MovePicture

此函数用于在系统运行时通过命令语言脚步来移动画面到所在的位

置。语法格式如下：

MovePicture(PicName,left,top); 参数 描述

PicName： 要移动画面的画面名称，字符串型

Left： 画面移动目标位置——画面的左边界坐标，整型 Top： 画面移动目标位置——画面的上边界坐标，整型 例如：

MovePicture(“信息提示”,50,100);

将画面“信息提示”移动到左边界距离坐标50，上边界距离坐标 100的位置。 PageDown

用于报警窗口信息的向前翻页显示。调用形式： PageDown(AlmWin, Lines); 参数：

AlmWin： 报警窗口名 Lines： 翻页行数 例如：

PageDown(全厂历史报警记录窗口,7); 组态王命令语言函数速查手册 北京亚控科技发展有限公司 59

该调用将“全厂历史报警记录窗口”的报警记录向下翻7 行 （如果有足够报警记录的话）。 PageUp

用于报警窗口信息的向后翻页显示。调用格式： PageUp(AlmWin, Lines); 参数：

AlmWin： 报警窗口名 Lines： 翻页行数 例如：

PageUp(全厂历史报警记录窗口,7);

该调用将“全厂历史报警记录窗口”的报警记录向上翻7 行 （如果有足够报警记录的话）. PI

此函数返回圆周率的值。调用格式： RealResult=PI(); 例如：

PI( );将返回 3.1415926... PlayAvi

此函数用于播放动画，动画为.avi 文件。调用格式： PlayAvi(\参数及其描述

CtrlName:用于播放播放AVI 动画的控件的名称。 组态王命令语言函数速查手册 北京亚控科技发展有限公司 60

filename:代表要播放的动画文件的字符串或字符串变量。 option:可为下述之一： 0 停止播放AVI 动画 1 播放一遍AVI 动画

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