精心整理组态王常用命令语言函数速查手册

GetRealDBForString

此函数用于获取变量的当前实时字符串型值。

语法使用格式 :GetRealDBForString ( \ 参数 描述

VarName： 变量名称，字符串格式 说明：变量只能是字符串型变量。 例如： ss= GetRealDBForString ( \记录日期\

GetStationStatus

此函数用于在组态王进行网络历史数据备份合并时获得备份的状态。使用时需要通过命令语言调用来获得状态值。

语法使用格式： BOOL GetStationStatus( str szStationName);

参数：szStationName 远程站点名称。返回值：离散型， >0 正在备份数据 =0空闲。 例如：备份状态= GetStationStatus (―IO采集站‖);

GetTime

此函数将以秒为单位的长整型数转换为相应的时间数值，分别以时、分、秒等的时间数值输出。该长整型秒数的基准为UTC(格林尼治)时间1970年1月1日00:00:00。转换完成输出的时间也为UTC(格林尼治)时间。

语法使用格式 :GetTime(DateTime,Hour,Minute,Second); 参数 描述

DateTime： 需要进行时间转换的数，整型，为输入参数 Hour： 时，整型，转换后得到的数据，输出参数 Minute： 分，整型，转换后得到的数据，输出参数 Second： 秒，整型，转换后得到的数据，输出参数 例如： 自UTC(格林尼治)时间1970年1月1日00:00:00到2003年8月8日0:8:9的秒的数值为1060301289，使用GetTime ()函数可以从这个数值中分离出所表示的日期——时、分、秒。

函数GetTime (1060301289,时,分,秒); 执行后，得到的―时‖的值为0，―分‖ 的值为8，―秒‖ 的值为9。 获得其中日期的函数为GetDate ()。

GetTimelocal

此函数将以秒为单位的长整型数转换为相应的时间数值，分别以本地的时、分、秒的时间数值输出。该长整型秒数的基准为UTC(格林尼治)时间1970年1月1日00:00:00。转换完成输出的时间为本地时间。

语法使用格式:GetTimelocal(DateTime,Hour,Minute,Second); 参数 描述

DateTime： 需要进行时间转换的数，整型，为输入参数 Hour： 时，整型，转换后得到的数据，输出参数 Minute： 分，整型，转换后得到的数据，输出参数

9

Second： 秒，整型，转换后得到的数据，输出参数

例如： 使用HTConvertTime函数将自UTC(格林尼治)时间1970年1月1日00:00:00到北京时间2006年9月26日9:22:4转换为以秒为单位的长整数数值为1159233724，使用GetTimelocal函数可以从这个数值中分离出所表示的北京时间——时、分、秒。 GetTimelocal (1159233724,时,分,秒); 执行后，得到的―时‖的值为9，―分‖ 的值为22，―秒‖ 的值为4。

HidePicture

此函数用于隐藏正在显示的画面，但并不将其从内存中删除。 调用格式： HidePicture(\画面名\； 参数：画面名称 字符串型

例如： HidePicture(\反应车间\；

HTConvertTime

此函数将指定的时间格式（年，月，日，时，分，秒）转换为以秒为单位的长整型数，转换的时间基准是UTC(格林尼治)1970年1月1日00:00:00。例：北京为东八区，那么转换的时间基准为1970 年1月1日8:00:00。

语法使用格式 :HTConvertTime(Year,Month,Day,Hour,Minute,Second); 参数 描述

Year： 年，整型，此值必须介于1970和2019之间 Month： 月，整型，此值必须介于1和12之间 Day： 日，整型，此值必须介于1和31之间 Hour： 小时，整型，此值必须介于0和23之间 Minute： 分钟，整型，此值必须介于0和59之间 Second： 秒，整型，此值必须介于0和59之间 返回值：整型 注： 调用此函数将用年、月、日、时、分、秒表示的时间转换成自1970年1月1日00:00:00即UCT起到该时刻所经过的秒数。在定义返回值变量时，应注意将其最大值置为整型数的最大范围，如2×109，否则可能会因为返回数据超出范围导致转换的时间不正确。 例如： 语句HTConvertTime(1970,1,1,9,0,0)执行后返回长整型数为3600;

HTGetPenRealValue

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

调用格式： HTGetPenRealValue(HistroyName,PenNum,ContentString); 参数说明

HistroyName 指在―历史趋势曲线‖对话框中定义的历史趋势曲线名称 PenNum 与历史趋势曲线中的一个变量相对应的趋势笔的索引号 ContentString 字符串常量

―start‖ 表示获取与历史趋势曲线的域ValueStart相对应的实际值，ValueStart是用

10

工程百分比来表示变量的下限值，start则表示将下限值的工程百分比转换为实际值。 ―end‖ 表示获取与历史趋势曲线的域ValueEnd相对应的实际值，ValueEnd是用工程百分比来表示变量的上限值，end则表示将上限值的工程百分比转换为实际值。 例如: 设有一温度历史曲线，其最大上限值为500，最小下限值为0，

如果用ValueStart和ValueEnd输出显示，则显示的数据是温度值的工程百分比，如ValueEnd 的输出为50，表示百分比是50%，如果使用函数语句 HTGetPenRealValue(histroy,1,―end‖)；

则函数返回工程百分比50%对应的实际值500*50%=250，其中history为历史趋势曲线名，1表示对应温度的趋势笔。

HTScrollRight

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

调用格式： HTScrollRight(HistoryName,Percent); 参数 描述

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

Percent 实数，代表图表要滚动的百分比(0.0到100.0)。 例如： 将趋势曲线Trend1的间轴范围向右滚动 20%。 调用函数: HTScrollRight(Trend1,20.0);

若当前显示起始于下午 12:00:00，而且显示宽度为60秒，则新的趋势将起始于下午 12:00:12 (在函数执行后)。

InfoAppDir info ['?nf??]信息，情报，统计dir[,di a? 'ɑr] 目录（directory）；方向

（direction）；用法（directione）；指示（direct）

此函数返回当前组态王的工程路径。

调用格式： MessageResult=InfoAppDir(); 当前组态王工程路径返回给MessageResult.

例如： DemoPath=InfoAppDir();

将返回 \。

InfoAppTitle title ['ta?t(?)l] n. 冠军；标题；头衔；权利；字幕

此函数返回应用程序的标题或者一个当前正在运行的指定程序的Windows任务列表名。 调用格式： MessageResult=InfoAppTitle(ProgramEXEName); 返回值：字符型值； 参数 描述

ProgramEXEName 应用程序的执行文件名。

例如： InfoAppTitle;(\将返回 \InfoAppTitle;(\将返回 \

InfoDisk

此函数返回指定的本地(或网络)磁盘驱动器信息。

调用格式： IntegerResult=InfoDisk(Drive,InfoType,Trigger);

11

参数 描述

Drive 代表驱动器号的字符串或字符串变量。若提供的字符串变量包含多于一个的字符，则只使用此变量的首字符。

InfoType 代表信息类型的整数，可为以下两个值之一： 1 返回磁盘驱动器的总空间数(以字节计)。

2 返回磁盘驱动器上可用的空闲空间数(以字节计)。 Trigger 每当 Trigger 的值改变时，执行 InfoDisk() 函数。Trigger 可为任何变量名(不受系统变量的限制)。 由驱动器号指定的磁盘驱动器的有关信息返回给 IntegerResult。

例如： 下面的语句每分钟执行一次并返回当前的值： InfoDisk(\分);//将返回C盘总空间数 InfoDisk(\分);//将返回C盘空闲空间数

InfoFile

此函数返回指定文件或子目录的有关信息。

调用格式： IntegerResult=InfoFile(Filename,InfoType,Trigger); 参数 描述

Filename 代表要处理的文件名的字符串。

InfoType 代表要获取的信息的类型的整数，可为以下值之一：

1 查找文件是否存在。若文件名是一个实际文件，返回1。若找不到文件则返回0。 2 文件大小（字节数）。

3 文件日期/时间（自1970年1月1日起的相对秒数）

4 与文件名描述相匹配的文件数。仅当使用通配符查找并找到多个匹配的文件时，返回值大于1。 Trigger为任一变量名，每当 Trigger 的值改变时，将执行 InfoFile() 函数。

由文件名指定的文件的有关信息返回给IntegerResult。文件名必须包括文件的完整路径，可包含通配符(*，?)。

例如： 下面的语句每分钟执行一次并返回下列值：

InfoFile(\分);将返回1，{文件找到}

InfoFile(\分);将返回634960，{文件大小} InfoFile(\分);将返回736701852， {自70年1月1日起的秒数} InfoFile(\4, $分);将返回4，{找到4个可执行文件}。

InfoResource

此函数返回各种系统资源值。

调用格式： IntegerResult=InfoResource(ResourceType,Trigger);

参数 描述 ResourceType 代表要监视的资源类型的整数，可为以下值之一： 1 返回GDI资源可用空闲空间的百分比。

12