6 组态王命令语言函数速查手册
红色）。
ｃｈａｒｔＳｅｔＶａｌｕｅ（）
此函数用于在指定的棒图控件中设定／修改索引值为Ｉｎｄｅｘ的条形图的数据。
语法格式使用如下：
ｃｈａｒｔＳｅｔＶａｌｕｅ（ ＂ＣｏｎｔｒｏｌＮａｍｅ＂， Ｉｎｄｅｘ， Ｖａｌｕｅ ）； 参数说明：
ＣｏｎｔｒｏｌＮａｍｅ：工程人员定义的棒图控件名称，可以为中文名或英文名。
Ｖａｌｕｅ：设定条形图的数据，整形数据， 实型数据。 Ｉｎｄｅｘ：条形图的标签值，，Ｉｎｄｅｘ的取值范围是１－１６，组态王自动从０开始加１，给每一个新增加的条形图由小到大设定标签值。 例如：
ｃｈａｒｔＳｅｔＶａｌｕｅ（ ＂ＸＹＣｈａｒｔ＂，２， ３０）；
此语句将在棒图控件ＸＹＣｈａｒｔ中设定索引值为２（第三条）的条形图的数据为 ３０。
ＣｌｏｓｅＰｉｃｔｕｒｅ
此函数用于将已调入内存的画面关闭，并从内存中删除。调用形式：
ＣｌｏｓｅＰｉｃｔｕｒｅ（＂画面名＂）； 例如：
ＣｌｏｓｅＰｉｃｔｕｒｅ（＂反应车间＂）； 将关闭画面“反应车间”。
Ｃｏｓ
此函数用于计算变量值的余弦值， 有效使用格式如下： Ｃｏｓ（数值或变量名）； 例如：
Ｃｏｓ（９０）； 返回值为０
Ｃｏｓ（ｔｅｍｐ）； 返回变量“ｔｅｍｐ”的余弦值。
ＤｉｓｐｌａｙＭＣＩ
此函数提供了一个对多媒体设备的通用接口，具有强大的功能。下面举例说明此函数的使用方法。 例如：
北京亚控自动化软件科技有限公司
组态王命令语言函数速查手册 7
ＤｉｓｐｌａｙＭＣＩ（“ＰＬＡＹＣＤ”，３）
用于播放ＣＤ唱片中的第３支歌曲。 ＤｉｓｐｌａｙＭＣＩ（“ＳＴＯＰＣＤ”，””） 用于停止播放ＣＤ。 ＤｉｓｐｌａｙＭＣＩ（“ＰＬＡＹＭＩＤＩ”，”ｃ：＼ｍｉｄｉ．ｍｉｄ”） 用于播放ＭＩＤＩ格式的背景音乐”ｃ：＼ｍｉｄｉ．ｍｉｄ”。 ＤｉｓｐｌａｙＭＣＩ（“ＰＡＵＳＥＭＩＤＩ”，” ｃ：＼ｍｉｄｉ．ｍｉｄ”） 暂停播放ＭＩＤＩ格式的背景音乐”ｃ：＼ｍｉｄｉ．ｍｉｄ”。 ＤｉｓｐｌａｙＭＣＩ（“ＲＥＳＵＭＭＩＤＩ”，” ｃ：＼ｍｉｄｉ．ｍｉｄ”） 继续播放ＭＩＤＩ格式的背景音乐”ｃ：＼ｍｉｄｉ．ｍｉｄ”。 ＤｉｓｐｌａｙＭＣＩ（“ＣＬＯＳＥＭＩＤＩ”，” ｃ：＼ｍｉｄｉ．ｍｉｄ”） 停止播放ＭＩＤＩ格式的背景音乐”ｃ：＼ｍｉｄｉ．ｍｉｄ”。 ＤｉｓｐｌａｙＭＣＩ（“ＥＪＥＣＴＣＤ”） 将光驱中的ＣＤ盘片弹出。
Ｄｔｅｘｔ
此函数用于按离散变量的值动态地改变字符串变量。调用形式：
Ｓｔｒ ＝ Ｄｔｅｘｔ（Ｄｉｓ，Ｓｔｒｉｎｇ１，Ｓｔｒｉｎｇ２）；
参数 描述 Ｄｉｓ 离散变量名。 Ｓｔｒｉｎｇ１ 字符串变量名 Ｓｔｒｉｎｇ２ 字符串变量名
当Ｄｉｓ＝１时，Ｓｔｒ的值为Ｓｔｒｉｎｇ１ 当Ｄｉｓ＝０时，Ｓｔｒ的值为Ｓｔｒｉｎｇ２ 例如：
Ｓｔｒ ＝ Ｄｔｅｘｔ（电源开关，＂电源打开＂，＂电源关闭＂）； 当电源开关＝１时，Ｓｔｒ的值为＂电源打开＂ 当电源开关＝０时，Ｓｔｒ的值为＂电源关闭＂。
ＥｄｉｔＵｓｅｒｓ
此函数常用于按钮的命令语言连接，功能是在画面程序运行中配置工程人员。调用形式：
ＥｄｉｔＵｓｅｒｓ（ ）；
北京亚控自动化软件科技有限公司
8 组态王命令语言函数速查手册
为配置其他工程人员，当前工程人员的权限必须不小于９００。
Ｅｘｉｔ（ ）
此函数使组态王运行环境退出。调用形式：
Ｅｘｉｔ（Ｏｐｔｉｏｎ）； 参数：
Ｏｐｔｉｏｎ： 整型变量或数值 ０－退出当前程序； １－关机；
２－重新启动ｗｉｎｄｏｗｓ；
Ｅｘｐ
此函数返回指数函数ｅｘ的计算结果，使用格式如下：
Ｅｘｐ（数值或变量值）； 例如：
Ｅｘｐ（１）； 返回ｅ１的计算值２．７１８
Ｅｘｐ（ｔｅｍｐ）； 计算ｅ常量的ｔｅｍｐ次幂并返回计算结果。
ＦｉｌｅＣｏｐｙ
此函数复制一个源文件到目的文件，它与 ＤＯＳ 的 Ｃｏｐｙ 命令或者 Ｗｉｎｄｏｗｓ 文件管理器中的 Ｃｏｐｙ 功能相似。调用格式：
ＦｉｌｅＣｏｐｙ（ ＳｏｕｒｃｅＦｉｌｅ，ＤｅｓｔＦｉｌｅ，ＤｏｎｅＴａｇ）；
参数
ＳｏｕｒｃｅＦｉｌｅ ＤｅｓｔＦｉｌｅ ＤｏｎｅＴａｇ
描述
源文件名（包含完整的路径）。
目的文件（包含完整的路径）或目录名（参见下面的例如子）。
用来报告复制过程进展情况的变量名称。此参数须是一个内存长整数或内存模拟型，随着复制过程的进行， 该值从０变化到１００。
返回值：
成功返回１；
北京亚控自动化软件科技有限公司
组态王命令语言函数速查手册 9
不能启动返回０； 出错返回－１；
例如：
Ｓｔａｔｕｓ＝ＦｉｌｅＣｏｐｙ（＂Ｃ：＼＊．ＴＸＴ＂， ＂Ｃ：＼ＢＡＣＫＵＰ＂， Ｍｏｎｉｔｏｒ）； Ｓｔａｔｕｓ：一个将被写为１、－１或０的整型变量。 Ｍｏｎｉｔｏｒ ：在数据词典中定义过的内存整数。
ＦｉｌｅＣｏｐｙ（）函数在后台执行，这样它不会干扰组态王 的运行。ＤｏｎｅＴａｇ 允许此复制操作的进展被应用程序或工程人员监视。用这种方法，在复制过程启动后可能发生的任何错误都能使用察觉（此处用变量Ｍｏｎｉｔｏｒ监测）。这与上述返回的 Ｓｔａｔｕｓ 不同，Ｓｔａｔｕｓ 表明的是复制过程是否已成功启动。一旦复制过程已成功启动，Ｍｏｎｉｔｏｒ 就会被赋值０。随着复制过程的进行，该值不断增加。当达到１００时，此过程成功结束，Ｓｔａｔｕｓ被置为１。若此过程结束前发生错误，则Ｓｔａｔｕｓ被置为－１。
ＳｏｕｒｃｅＦｉｌｅ 和 ＤｅｓｔＦｉｌｅ 一般为文件名。但用ＦｉｌｅＣｏｐｙ（） 函数复制单一文件时，目标文件名可以是一个目录， 如：
ＦｉｌｅＣｏｐｙ（＂Ｃ：＼ＤＡＴＡ．ＴＸＴ＂， ＂Ｃ：＼ＢＡＣＫＵＰ＂， Ｍｏｎｉｔｏｒ）； 将把文件“ＤＡＴＡ．ＴＸＴ”复制到“Ｃ：＼”驱动器上一个叫做“ＢＡＣＫＵＰ”的目录下。变量 Ｍｏｎｃｔｏｒ 在复制完成后置为１。
若 ＳｏｕｒｃｅＦｉｌｅ 包含任何通配符的话，ＤｅｓｔＦｉｌｅ 必须是一个目录（而非文件名），否则此函数将返回一个错误代码， 如：
ＦｉｌｅＣｏｐｙ（＂Ｃ：＼＊．ＴＸＴ＂， ＂Ｃ：＼ＢＡＣＫＵＰ＂， Ｍｏｎｉｔｏｒ）；
将把Ｃ盘根目录下所有的．ＴＸＴ文件复制到Ｃ：＼ＢＡＣＫＵＰ目录下，Ｍｏｎｉｔｏｒ在复制完成后置１００。
ＦｉｌｅＤｅｌｅｔｅ
此函数删除不需要或不想要的文件。调用格式：
ＦｉｌｅＤｅｌｅｔｅ（Ｆｉｌｅｎａｍｅ）； 参数 描述
北京亚控自动化软件科技有限公司
10 组态王命令语言函数速查手册
Ｆｉｌｅｎａｍｅ 要删除的文件名。
若找到要删除的文件，并成功地删除，此函数将返回１，否则此函数返回０。 例如：
Ｓｔａｔｕｓ＝ＦｉｌｅＤｅｌｅｔｅ（＂Ｃ：＼ＤＡＴＡ．ＴＸＴ＂）；
若在 Ｃ：＼找到 ＂ＤＡＴＡ．ＴＸＴ＂ 则Ｓｔａｔｕｓ 等于１， 未找到该文件则为０。
ＦｉｌｅＭｏｖｅ
此函数与 ＦｉｌｅＣｏｐｙ （）函数相似，但只是将文件从一个位置转移到另一个位置，而不是复制。调用格式：
ＦｉｌｅＭｏｖｅ（ＳｏｕｒｃｅＦｉｌｅ， ＤｅｓｔＦｉｌｅ， ＤｏｎｅＴａｇ）； 参数 描述 ＳｏｕｒｃｅＦｉｌｅ 源文件名（包含完整的路径） ＤｅｓｔＦｉｌｅ 目的文件名（包含完整的路径） ＤｏｎｅＴａｇ 用来报告移动过程进展情况的变量名称。此
参数须是一个内存长整数或内存模拟型，随着转移过程的进行， 该值从０变化到１００。
返回值： 成功返回１； 不能启动返回０； 出错返回－１； 例如：
Ｓｔａｔｕｓ＝ＦｉｌｅＭｏｖｅ（＂Ｃ：＼ＤＡＴＡ．ＴＸＴ＂，＂Ｄ：＼ＤＡＴＡ．ＴＸＴ＂，Ｍｏｎｉｔｏｒ）； Ｓｔａｔｕｓ 是一个将被写为１、－１或０的整型变量。 Ｍｏｎｉｔｏｒ ：在数据词典中定义过的内存整数。
ＦｉｌｅＭｏｖｅ（） 函数在后台执行，这样它不会干扰“组态王”的运行。使用 ＤｏｎｅＴａｇ 是为了允许应用程序或工程人员监视转移操作的进展。用这种方法，在转移过程启动后可能发生的任何错误都能使工程人员察觉。（此处用变量Ｍｏｎｉｔｏｒ监测）这与上述返回的Ｓｔａｔｕｓ不同，Ｓｔａｔｕｓ表明的是转移过程是否已成功启动。一旦转移过程已成功启动，Ｍｏｎｉｔｏｒ 就会被赋值
北京亚控自动化软件科技有限公司