26 组态王命令语言函数速查手册
３ 返回当前内存中空闲空间字节数
４ 返回当前正在运行的任务数。 Ｔｒｉｇｇｅｒ 每当 Ｔｒｉｇｇｅｒ 值改变时，执行ＩｎｆｏＲｅｓｏｕｒｃｅ（） 函数。Ｔｒｉｇｇｅｒ 可为任一变量名（不受系统变量限制）。
由整数 ＲｅｓｏｕｒｃｅＴｙｐｅ 指定的特定系统资源信息存放在 ＩｎｔｅｇｅｒＲｅｓｕｌｔ 中。 例如：
下面的语句每分钟执行一次并返回当前值： ＩｎｆｏＲｅｓｏｕｒｃｅ（１， ￥分） 将返回５４｛空闲百分比｝ ＩｎｆｏＲｅｓｏｕｒｃｅ（２， ￥分） 将返回３６｛空闲百分比｝ ＩｎｆｏＲｅｓｏｕｒｃｅ（３， ￥分） 将返回１１５２４０９３｛字节数｝ ＩｎｆｏＲｅｓｏｕｒｃｅ（４， ￥分） 将返回１４｛任务数｝ 注意： 在ＷＩＮ ＮＴ 下返回ＧＤＩ和ＵＳＥＲ的资源可用空闲空间的百分比是一样的，与ＷＩＮ ＮＴ系统有关。
Ｉｎｔ
此函数返回小于等于指定数值的最大整数。调用格式：
ＩｎｔｅｇｅｒＲｅｓｕｌｔ＝Ｉｎｔ（Ｎｕｍｂｅｒ）；
参数 描述
Ｎｕｍｂｅｒ 任一数字或者组态王的实型或整型变量名。 例如：
Ｉｎｔ（４．７） 将返回 ４ Ｉｎｔ（－４．７） 将返回 －５
ＩｓＰｌａｙＳｏｕｎｄＥｎｄ
此函数用于判断声音播放是否结束，返回值为离散型，当返回值为１时，表示声音播放结束；返回值为０时，表示声音正在播放。 调用格式：
ＩｓＰｌａｙＳｏｕｎｄＥｎｄ（） 此函数无参数。
ｌｉｓｔＬｏａｄＬｉｓｔ（）
北京亚控自动化软件科技有限公司
组态王命令语言函数速查手册 27
此函数用于将ＣＳＶ文件Ｆｉｌｅｎａｍｅ中的列表项调入指定的列表框控件ＣｏｎｔｒｏｌＮａｍｅ中，并替换列表框中的原有列表项。列表框中只显示列表项的成员名称（字符串信息），而不显示相关的数据值。 语法格式使用如下：
ｌｉｓｔＬｏａｄＬｉｓｔ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，＂Ｆｉｌｅｎａｍｅ＂）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。
Ｆｉｌｅｎａｍｅ：ｃｓｖ文件，用写字板程序进行编辑，用以存放列表框中要显示的列表项。 例如：
ｌｉｓｔＬｏａｄＬｉｓｔ（＂组合框信息＂，＂ｃ：＼组态王＼ｌｉｓｔ．ｃｓｖ＂）；
此语句将指定的文件ｌｉｓｔ．ｃｓｖ调入名为组合框信息的列表框中并显示出来。 注：
如果没有给出ｃｓｖ文件所在的完整路径，则该函数就从组态王所在的路径下寻找指定的文件。
ｌｉｓｔＳａｖｅＬｉｓｔ（）
此函数用于将列表框控件ＣｏｎｔｒｏｌＮａｍｅ中的列表项信息存入ＣＳＶ文件Ｆｉｌｅｎａｍｅ中。如果该文件不存在，则直接创建。 语法格式使用如下：
ｌｉｓｔＳａｖｅＬｉｓｔ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，＂Ｆｉｌｅｎａｍｅ＂）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。
Ｆｉｌｅｎａｍｅ：ＣＳＶ文件，按一定格式用以存放列表框中的列表项。 例如：
ｌｉｓｔＳａｖｅＬｉｓｔ（＂组合框信息＂，＂ｃ：＼组态王＼ｌｉｓｔ．ｃｓｖ＂）；
此语句将组合框信息列表框中的列表项存入到文件ｃ：＼组态王＼ｌｉｓｔ．ｃｓｖ中。 注：
如果没有给出ＣＳＶ文件所在的完整路径，则该函数在组态王所
北京亚控自动化软件科技有限公司
28 组态王命令语言函数速查手册
在的路径下创建该文件。
ｌｉｓｔＡｄｄＩｔｅｍ（）
此函数将给定的列表项字符串信息ＭｅｓｓａｇｅＴａｇ增加到指定的列表框
控件ＣｏｎｔｒｏｌＮａｍｅ中并显示出来。组态王将增加的字符串信息作为列表框中的一个成员项 Ｉｔｅｍ，并自动给这个成员项定义一个索引号ＩｔｅｍＩｎｄｅｘ，索引号ＩｔｅｍＩｎｄｅｘ从１开始由小到大自动加１。 语法格式使用如下：
ｌｉｓｔＡｄｄＩｔｅｍ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，＂ＭｅｓｓａｇｅＴａｇ＂）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。
ＭｅｓｓａｇｅＴａｇ：字符串值，表示增加到指定列表框控件的成员项字符串信息。 例如：
ｌｉｓｔＡｄｄＩｔｅｍ（＂报警信息＂，＂温度报警＂）；
此语句将“温度报警” 字符串信息增加到列表框控件报警信息中并显示出来。
ｌｉｓｔＡｄｄＩｔｅｍ（＂配方信息＂，＂巧克力面包＂）；
此语句将“巧克力香型面包” 字符串信息增加到列表框控件配方信息中并显示出来。
ｌｉｓｔＣｌｅａｒ（）
此函数将清除指定列表框控件ＣｏｎｔｒｏｌＮａｍｅ中的所有列表成员项。 语法格式使用如下：
ｌｉｓｔＣｌｅａｒ（＂ＣｏｎｔｒｏｌＮａｍｅ＂）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。 例如：
ｌｉｓｔＣｌｅａｒ（＂报警信息＂）；
此语句将清除报警信息列表框中的所有列表成员项。
北京亚控自动化软件科技有限公司
组态王命令语言函数速查手册 29
ｌｉｓｔＤｅｌｅｔｅＩｔｅｍ（）
此函数将在指定的列表框控件ＣｏｎｔｒｏｌＮａｍｅ中删除索引号为ＩｔｅｍＩｎｄｅｘ的成员项。 语法格式使用如下：
ｌｉｓｔＤｅｌｅｔｅＩｔｅｍ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，ＩｔｅｍＩｎｄｅｘ）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。
ＩｔｅｍＩｎｄｅｘ：列表框控件中的成员项索引号，通常为数字常量或整型变量。 例如：
ｌｉｓｔＤｅｌｅｔｅＩｔｅｍ（＂报警信息＂，１）；
此语句将在报警信息列表框中删除索引号为１的成员项。 ｌｉｓｔＤｅｌｅｔｅＩｔｅｍ（＂配方信息＂，５）；
此语句将在配方信息列表框中删除索引号为５的成员项。
ｌｉｓｔＤｅｌｅｔｅＳｅｌｅｃｔｉｏｎ（）
此函数将删除列表框控件ＣｏｎｔｒｏｌＮａｍｅ中当前选定的成员项。 语法格式使用如下：
ｌｉｓｔＤｅｌｅｔｅＳｅｌｅｃｔｉｏｎ（＂ＣｏｎｔｒｏｌＮａｍｅ＂）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。 例如：
ｌｉｓｔＤｅｌｅｔｅＳｅｌｅｃｔｉｏｎ（＂报警信息＂）；
此语句将在报警信息列表框中删除当前选定的成员项。
ｌｉｓｔＦｉｎｄＩｔｅｍ（）
此函数用于查找与给定的成员字符串信息ＭｅｓｓａｇｅＴａｇ相对应的索引号，并送给整型变量ＩｎｄｅｘＴａｇ。 语法格式使用如下：
ｌｉｓｔＦｉｎｄＩｔｅｍ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，＂ＭｅｓｓａｇｅＴａｇ＂，ＩｎｄｅｘＴａｇ）； 参数说明：
北京亚控自动化软件科技有限公司
30 组态王命令语言函数速查手册
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英
文名。
ＭｅｓｓａｇｅＴａｇ：字符串值，表示列表成员项字符串信息。
ＩｎｄｅｘＴａｇ：整型变量，用以存放与给定的成员字符串信息ＭｅｓｓａｇｅＴａｇ相对应的索引号 例如：
以ＣＳＶ文件ｌｉｓｔ．ｃｓｖ中存放的列表项信息为例如， ｌｉｓｔＦｉｎｄＩｔｅｍ（＂组合框信息＂，＂温度＂，ＩｎｄｅｘＴａｇ）；
此语句将“温度” 字符串信息相对应的索引号送给整型变量ＩｎｄｅｘＴａｇ。在此例如中ＩｎｄｅｘＴａｇ＝１。
ｌｉｓｔＧｅｔＩｔｅｍ（）
此函数用于获取索引号为ＩｔｅｍＩｎｄｅｘ的列表项成员字符串信息，并送给字符串变量ＳｔｒｉｎｇＴａｇ。 语法格式使用如下：
ｌｉｓｔＧｅｔＩｔｅｍ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，ＩｔｅｍＩｎｄｅｘ，ＳｔｒｉｎｇＴａｇ）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的列表框控件名称，可以为中文名或英文名。
ＩｔｅｍＩｎｄｅｘ：数值常量或变量，表示列表索引号。
ＳｔｒｉｎｇＴａｇ：字符串变量，用以存放索引号为ＩｔｅｍＩｎｄｅｘ的列表项成员字符串信息 例如：
以ＣＳＶ文件ｌｉｓｔ．ｃｓｖ中存放的列表项信息为例如， ｌｉｓｔＧｅｔＩｔｅｍ（＂组合框信息＂，２，ＳｔｒｉｎｇＴａｇ）；
此语句将索引号为２的列表项成员字符串信息字符串变量ＳｔｒｉｎｇＴａｇ。在此例如中，ＳｔｒｉｎｇＴａｇ＝压力。
ｌｉｓｔＧｅｔＩｔｅｍＤａｔａ（）
此函数用于获取索引号为ＩｔｅｍＩｎｄｅｘ的列表项中的数据值，并送给整型变量ＮｕｍｂｅｒＴａｇ。 语法格式使用如下：
ｌｉｓｔＧｅｔＩｔｅｍＤａｔａ（＂ＣｏｎｔｒｏｌＮａｍｅ＂，ＩｔｅｍＩｎｄｅｘ，ＮｕｍｂｅｒＴａｇ ）；
北京亚控自动化软件科技有限公司