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

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

《精心整理组态王常用命令语言函数速查手册.docx》由会员分享，可在线阅读，更多相关《精心整理组态王常用命令语言函数速查手册.docx（41页珍藏版）》请在冰点文库上搜索。

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

组态王命令语言函数手册

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

Abs

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

Abs（变量名或数值）;返回值：

整值或实型值；例如：

Abs（14）;返回值为14Abs（-7.5）;返回值为7.5

Abs（距离）;返回内存模拟变量“距离”的绝对值。

Ack

对变量进行报警确认，或对报警组进行报警确认。

如果函数参数为变量名称，则只对该变量进行报警确认；如果函数参数为报警组名称，则确认所有属于该报警组及其子报警组的变量。

该函数的参数只能是变量名或报警组名，不可以为字符串变量。

此函数常用于按钮命令语言，当发生报警时，用此函数进行报警确认，它将产生确认报警事件。

调用格式：

Ack（报警组名）；或Ack（变量名）；

例如：

Ack（全厂）；或Ack（反应罐液位）；

ActivateAppactivate['æktɪveɪt]vt.刺激；使活动；使活泼；使产生放射性app[æp]n.应用程序

此函数用于激活正在运行的窗口应用程序，使之变为当前窗口。

获得输入焦点。

该函数也可配合函数SendKeys的使用。

调用形式：

ActivateApp（“ExeName”）；

参数：

ExeName应用程序的执行文件名

例如：

激活MicrosoftWord的正确调用为：

ActivateApp（"Word.exe"）；

ArcCosarc[ɑːk]adj.圆弧的；反三角函数的

此函数用于计算变量值的反余弦值,变量值的取值范围在[-1，1]之间，否则函数返回值无效。

调用格式：

ArcCos（变量名或数值）;返回值：

整值或实型值；

例如：

ArcCos

（1）;此函数返回值为0ArcCos（temp）;此函数返回变量“temp”的反余弦值。

Average['æv（ə）rɪdʒ]n.平均；平均数；adj.平均的vt.算出…的平均数；将…平均分配；使…平衡

此函数为对指定的组态王报表表格的多个单元格求平均值，或求多个变量的平均值。

语法格式使用如下：

Average（’a1’,’a2’）;或Average（'a1:

a10'）;a1、a2……为组态王单元格所在的行号列标，或整型或实型变量。

其中参数个数为1-32个。

当对报表的指定单元格区域内的单元格进行求平均值运算时，结果显示在当前单元格内，语法格式使用如下：

Average（’a1’,‘a2‘）;

例如：

任意单元格选择求平均值:

=Average（‘a1’,‘b2’,‘r10’）;连续的单元格求平均值:

=Average（‘b1:

b10’）;或求变量的平均值：

AverageValue=Average（lVar1,fVar1）;

BackUpHistDatahistory[hɪst]hist-历史

此函数为组态王网络中从IO服务器上下载历史数据记录到历史记录服务器。

用户在历史记录服务器上调用该函数。

函数的使用需要与组态王网络配置相配合，具体内容参见《组态王6.53使用手册》中“历史库”一章。

语法使用格式：

BackupStationData（StrchMchinename,LongftEndtime）;

参数：

chMchinename字符串型为进行备份存储的IO服务器名ftEndtime整型为备份截止时间

例如：

//备份“IO采集站”的历史数据，截至时间为当前：

endTime=HTConvertTime（$年,$月,$日,$时,$分,0）;BackUpHistData（"IO采集站",endTime）;

Bit

此函数用以取得一个整型或实型变量某一位的值（0或1）。

用法：

OnOff=Bit（Var,bitNo）;//OnOff:

离散变量参数：

Var:

整型或实型变量

bitNo:

位的序号，取值1至16返回值：

离散型。

若变量Var的第bitNo位为0，返回值OnOff为0；若变量Var的第bitNo位为1，返回值OnOff为1。

例如：

开关=Bit（DDE1,6）;从变量DDE1的第6位得到变量“开关”状态。

BitSet

此函数将一个整型或实型变量的任一位置为指定值（0或1）。

语法格式：

BitSet（Var,bitNo,OnOff）;参数：

Var:

整型或实型变量

bitNo:

位的序号，取值1至16OnOff:

位的设定值

注意：

对于IO变量来说，BitSet函数只是用于可读可写的变量。

例如：

BitSet（DDE1,6,0）;将变量DDE1的第6位置为0。

ChangePasswordpassword['pɑːswɜːd]n.密码；口令

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

使用格式：

ChangePassword（）;例如：

为画面上某一按钮设置命令语言连接：

ChangePassword（）;

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

提示工程人员输入当前的口令和新口令以及验证新口令。

完全正确后，工程人员的口令设置为新值。

ClosePicture

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

语法格式如下：

ClosePicture（"画面名"）;例如：

ClosePicture（"反应车间"）;将关闭画面“反应车间”。

ConfigODBC

此函数用于配置odbc的数据源，语法格式如下：

ConfigODBC（nDatatbasetype,szAttributes）;

参数：

nDatatbasetype：

数据库类型，目前支持Access，SQLserver该参数为0时表示数据库类型为Access，参数为1时表示数据库类型为SQLserver；szAttributes：

配置字符串:

例1：

配置Access数据库，DSN名称为demo2，数据库文件为

E:

\ProgramFiles\Kingview\Example\Kingdemo1\数据库.mdb。

ConfigODBC（0,"DSN=demo2\0Description=E:

\ProgramFiles\Kingview\Example\Kingdemo1\数据库.mdb\0PWD=1234\0UID=shihf"）;

例2：

配置SQL数据库：

ConfigODBC（1,"DSN=MyDSN\0Description=SQLConfigDSN

Sample\0SERVER=MySQL\0ADDRESS=MyServer\0NETWORK=dbmssocn\0DATABASE=pubs\0"）;

Date

此函数为根据给出的年、月、日整型数，返回日期字符串，默认格式为：

年：

月：

日。

语法使用格式如下：

Date（LONGnYear,LONGnMonth,LONGnDay）;

例如：

年、月、日变量分别为：

“$年”、“$月”、“$日”，用日期来显示由以上三个整数决定的“日期”字符串，则在命令语言中输入：

日期=Date（年,月,日）;

DisplayMCI

此函数提供了一个对多媒体设备的通用接口，具有强大的功能。

语法使用格式：

DisplayMCI（"MCICommand",option）;下面举例说明此函数的使用方法。

例如：

DisplayMCI（“PLAYCD”,3）;用于播放CD唱片中的第3支歌曲。

DisplayMCI（“STOPCD”,””）;用于停止播放CD。

DisplayMCI（“PLAYMIDI”,”c:

\midi.mid”）;用于播放MIDI格式的背景音乐”c:

\midi.mid”。

DisplayMCI（“PAUSEMIDI”,”c:

\midi.mid”）;暂停播放MIDI格式的背景音乐”c:

\midi.mid”。

DisplayMCI（“RESUMMIDI”,”c:

\midi.mid”）;继续播放MIDI格式的背景音乐”c:

\midi.mid”。

DisplayMCI（“CLOSEMIDI”,”c:

\midi.mid”）;停止播放MIDI格式的背景音乐”c:

\midi.mid”。

DisplayMCI（“EJECTCD”）;将光驱中的CD盘片弹出。

Dtext

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

语法格式如下：

Str=Dtext（Discrete_Tag,OnMsg,OffMsg）；参数

描述

Discrete_Tag

离散变量名。

OnMsg

字符串变量名

OffMsg

字符串变量名

当Discrete_Tag＝1时，Str的值为OnMsg当Discrete_Tag＝0时，Str的值为OffMsg

例如：

Str=Dtext（电源开关，"电源打开","电源关闭"）;

当电源开关＝1时，Str的值为"电源打开当电源开关＝0时，Str的值为"电源关闭"。

"

EnableAllAlarm

全局报警使能函数。

调用形式：

EnableAllAlarm（is_enable）;

参数描述：

is_enable整数变量或数值0--禁止所有报警非0--使能所有报警

返回值：

整数型，反映当前全局报警使能的状态：

若为非0：

使能；为0：

禁止

EnableNavigate

此函数用于显示/关闭导航图。

调用形式：

EnableNavigate（is_enable）;

参数：

is_enable，整型。

0:

is_enable为0时，关闭导航图1:

is_enable为1时，显示导航图。

使用EnableNavigate函数关闭导航图后，除非使用该函数来显示导航图，否则无法显示导航图。

例如：

EnableNavigate（0）;//关闭导航图

EnableSaveTagValueToIniValueWhenValueChange

对于设置了“保存数值”和“保存参数”的变量，使用该函数后，当变量的值和参数发生变化时，系统会自动将变量的值和参数保存到文件tagname.db中，无论组态王运行系统是否正常退出，再次运行后，将保存的变量值和变量参数作为变量的初始值和初始参数。

“保存数值”和“保存参数”的具体含义请参见《组态王手册》第七章变量定义和管理部分。

调用形式：

EnableSaveTagValueToIniValueWhenValueChange（is_enable）;

参数：

is_enable：

整型变量或数值

1：

当变量的值和参数发生变化时，保存变量数值和参数。

组态王运行系统退出，再次运行后，将保存的变量值和变量参数作为变量的初始值和初始参数。

0：

与组态王“保存数值”和“保存参数”实现的功能相同。

例如：

组态王开发系统数据词典中定义变量，设置“保存数值”。

执行函数：

EnableSaveTagValueToIniValueWhenValueChange

（1）;

该变量的值发生变化时，系统保存该变量的值。

组态王运行系统退出，再次运行后，将保存的变量值作为变量的初始值。

Exit

此函数使组态王运行环境退出。

调用形式：

Exit（Option）;

参数：

Option:

整型变量或数值0-退出当前程序；1-关机；2-重新启动windows；

Exp

此函数返回指数函数ex的计算结果

使用格式如下：

Exp（数值或变量名）;

例如：

Exp

（1）;返回e1的计算值2.718Exp（temp）;计算e常量的temp次幂并返回计算结果。

GetAlarmNumInGroup

此函数用来对某一个报警组当前的报警变量数量进行统计

语法格式：

longGetAlarmNumInGroup（"MachineName","GroupName"）;参数说明：

MachineName：

报警组所在的站点名称（对于单机网络，使用时用空字符串代替）

GroupName：

要获取报警变量个数的报警组名返回值：

整型，返回值表示报警变量数量特别说明：

对于网络节点，需要把“本机为报警服务器”钩上，才能正确获取到远程节点的报警变量个数。

GetBackupProgress

此函数用于在组态王进行网络历史数据备份合并时获得进度百分比。

使用时需要通过命令语言调用来获得进度值。

语法使用格式：

GetBackupProgress（strszStationName）;

参数：

szStationName远程站点名称。

返回值：

整型，为0~100间的进度值。

例如：

备份进度=GetBackupProgress（“IO采集站”）;

GetCursorPosX

此函数返回当前鼠标的X坐标。

调用格式：

result=GetCursorPosX（）;返回值为整型。

GetCursorPosY

此函数返回当前鼠标的Y坐标。

调用格式：

result=GetCursorPosY（）;返回值为整型。

GetDatelocal

此函数将以秒为单位的长整型数转换为相应的日期数值，分别以年、月、日的日期数值输出。

该长整型秒数的基准为UTC（格林尼治）时间1970年1月1日00:

00:

00。

转换完成输出的日期为本地日期。

语法使用格式GetDatelocal（DateTime,Year,Month,Day）;

参数描述

DateTime：

需要进行日期转换的数，整型，为输入参数

Year：

年，整型，转换后得到的数据，输出参数

Month：

月，整型，转换后得到的数据，输出参数

Day：

日，整型，转换后得到的数据，输出参

例如：

使用HTConvertTime函数将自UTC（格林尼治）时间1970年1月1日00:

00:

00到北京时间2006年9月26日9:

22:

4转换为以秒为单位的长整数数值为1159233724，使用GetDatelocal函数可以从这个数值中分离出所表示的北京日期——年、月、日。

GetDatelocal（1159233724,年,月,日）;执行后，得到的“年”的值为2006，“月”的值为9，“日”的值为26。

数可以从这个数值中分离出所表示的日期——年、月、日。

函数GetDate（1060301289,年,月,日）;执行后，得到的“年”的值为2003，“月”的值为8，“日”的值为8。

获得其中时间的函数为GetTime（）。

GetGroupName

此函数为通过报警组ID号获得报警组名称。

在组态王中，每个报警组除了名称外，还有ID号。

组态王的变量域“.Group”显示的是变量所属报警组的ID号，如果要获得相应的报警组名称，就需要使用该函数。

语法使用格式:

sGroupName=GetGroupName（StationName,GroupID）;

参数描述

StationName：

报警组所在的站点名称（该项暂时无效，使用时用空字符串代替）

GroupID：

要获取名称的报警组的ID号返回值为字符串型。

例如：

GroupName=GetGroupName（“”,\\本站点\原料罐液位.Group）;

GetHistMaxData

此函数用来获取某段时间中历史数据的最大值

语法使用格式：

RealResult=GetHistMaxData（TagName,StartTime,EndTime）;

参数描述：

TagName：

所要查询的变量的名称，类型为字符串型，即带引号。

StartTime：

数据查询的开始时间，该时间是通过组态王HTConvertTime函数转化的以1969年12月31日16：

00：

00为基准的长整型数，所以用户在使用本函数之前，应先将查询起始时间转换为长整型数值。

EndTime:

数据查询的结束时间，类型同StartTime。

返回值：

返回一个实数值。

GetHistMinData

此函数用来获取某段时间中历史数据的最小值

语法使用格式：

RealResult=GetHistMinData（TagName,StartTime,EndTime）;

参数描述：

TagName：

所要查询的变量的名称，类型为字符串型，即带引号。

StartTime：

数据查询的开始时间，该时间是通过组态王HTConvertTime函数转化的以1969年12月31日16：

00：

00为基准的长整型数，所以用户在使用本函数之前，应先将查询起始时间转换为长整型数值。

EndTime:

数据查询的结束时间，类型同StartTime。

返回值：

返回一个实数值。

GetHistAveData

此函数用来获取某段时间中历史数据的平均值

语法使用格式：

RealResult=GetHistAveData（TagName,StartTime,EndTime）;

参数描述：

TagName：

所要查询的变量的名称，类型为字符串型，即带引号。

StartTime：

数据查询的开始时间，该时间是通过组态王HTConvertTime函数转化的以1969年12月31日16：

00：

00为基准的长整型数，所以用户在使用本函数之前，应先将查询起始时间转换为长整型数值。

EndTime:

数据查询的结束时间，类型同StartTime。

返回值：

返回一个实数值。

GetHistMaxTime

此函数用来获取某段时间中历史数据的最大值对应的时间

语法使用格式：

RealResult=GetHistMaxTime（TagName,StartTime,EndTime）;

参数描述：

TagName：

所要查询的变量的名称，类型为字符串型，即带引号。

StartTime：

数据查询的开始时间，该时间是通过组态王HTConvertTime函数转化的以1969年12月31日16：

00：

00为基准的长整型数，所以用户在使用本函数之前，应先将查询起始时间转换为长整型数值。

EndTime:

数据查询的结束时间，类型同StartTime。

返回值：

返回一个字符串，格式为2008/10/1011:

11:

11。

GetHistMinTime

此函数用来获取某段时间中历史数据的最小值对应的时间

语法使用格式：

RealResult=GetHistMinTime（TagName,StartTime,EndTime）;

参数描述：

TagName：

所要查询的变量的名称，类型为字符串型，即带引号。

StartTime：

数据查询的开始时间，该时间是通过组态王HTConvertTime函数转化的以1969年12月31日16：

00：

00为基准的长整型数，所以用户在使用本函数之前，应先将查询起始时间转换为长整型数值。

EndTime:

数据查询的结束时间，类型同StartTime。

返回值：

返回一个字符串，格式为2008/10/1011:

11:

11。

GetKey

此函数为获得组态王当前使用的加密锁的序列号。

语法使用格式KeyID=GetKey（）;

该函数没有任何参数。

返回值为字符串型。

GetProjectPath

此函数用于获取当前工程的路径。

语法使用格式:

GetProjectPath（）;

例如：

在组态王数据词典中定义内存字符串变量VarName：

VarName=GetProjectPath（）;

GetRealDBForBool

此函数用于获取变量的当前实时离散值。

语法使用格式:

GetRealDBForBool（"VarName"）;

参数描述

VarName：

变量名称，字符串格式说明：

变量只能是离散量。

返回值为离散型。

例如：

bb=GetRealDBForBool（"原料油出料阀"）;

GetRealDBForFloat

此函数用于获取变量的当前实时模拟值。

语法使用格式:

GetRealDBForFloat（"VarName"）;

参数描述

VarName：

变量名称，字符串格式说明：

变量只能是实型变量。

例如：

ff=GetRealDBForFloat（"原料油液位"）;

GetRealDBForInt

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

语法使用格式:

GetRealDBForInt（"VarName"）;

参数描述

VarName：

变量名称，字符串格式说明：

变量只能是整型变量。

例如：

ii=GetRealDBForInt（"水果"）;

GetRealDBForString

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

语法使用格式:

GetRealDBForString（"VarName"）;

参数描述

VarName：

变量名称，字符串格式说明：

变量只能是字符串型变量。

例如：

ss=GetRealDBForString（"记录日期"）;

GetStationStatus

此函数用于在组态王进行网络历史数据备份合并时获得备份的状态。

使用时需要通过命令语言调用来获得状态值。

语法使用格式：

BOOLGetStationStatus（strszStationName）;

参数：

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：

分，整型，转换后得到的数据，输出参数

Second：

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

例如：

使用HTConvertTime函数将自UTC（格林尼治）时间1