精心整理组态王常用命令语言函数速查手册簿.docx
- 文档编号:12698566
- 上传时间:2023-04-21
- 格式:DOCX
- 页数:41
- 大小:48.59KB
精心整理组态王常用命令语言函数速查手册簿.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]
此函数用于激活正在运行的窗口应用程序,使之变为当前窗口。
获得输入焦点。
该函数也可配合函数SendKeys的使用。
调用形式:
ActivateApp(“ExeName〞);
参数:
ExeName应用程序的执行文件名
例如:
激活MicrosoftWord的正确调用为:
ActivateApp("Word.exe");
ArcCosarc[ɑːk]adj.圆弧的;反三角函数的
此函数用于计算变量值的反余弦值,变量值的取值X围在[-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服务器上下载历史数据记录到历史记录服务器。
用户在历史记录服务器上调用该函数。
函数的使用需要与组态王网络配置相配合,具体内容参见《组态王使用手册》中“历史库〞一章。
语法使用格式:
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=dbmsso\0DATABASE=pubs\0");
Date
此函数为根据给出的年、月、日整型数,返回日期字符串,默认格式为:
年:
月:
日。
语法使用格式如下:
Date〔LONGnYear,LONGnMonth,LONGnDay〕;
例如:
年、月、日变量分别为:
“$年〞、“$月〞、“$日〞,用日期来显示由以上三个整数决定的“日期〞字符串,如此在命令语言中输入:
日期=Date〔年,月,日〕;
DisplayMCI
此函数提供了一个对多媒体设备的通用接口,具有强大的功能。
语法使用格式:
DisplayMCI("MCImand",option);下面举例说明此函数的使用方法。
例如:
DisplayMCI(“PLAYCD〞,3);用于播放CD唱片中的第3支歌曲。
DisplayMCI(“STOPCD〞,〞〞);用于停止播放CD。
DisplayMCI(“PLAYMIDI〞,〞〞);用于播放MIDI格式的背景音乐〞〞。
DisplayMCI(“PAUSEMIDI〞,〞〞);暂停播放MIDI格式的背景音乐〞〞。
DisplayMCI(“RESUMMIDI〞,〞〞);继续播放MIDI格式的背景音乐〞〞。
DisplayMCI(“CLOSEMIDI〞,〞〞);停止播放MIDI格式的背景音乐〞〞。
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
对于设置了“保存数值〞和“保存参数〞的变量,使用该函数后,当变量的值和参数发生变化时,系统会自动将变量的值和参数保存到文件中,无论组态王运行系统是否正常退出,再次运行后,将保存的变量值和变量参数作为变量的初始值和初始参数。
“保存数值〞和“保存参数〞的具体含义请参见《组态王手册》第七章变量定义和管理局部。
调用形式:
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(格林尼治)时间1970年1月1日00:
00:
00到时间2006年9月26日9:
22:
4转换为以秒为单位的长整数数值为1159233724,使用GetTimelocal函数可以从这个数值中别离出所表示的时间——时、分、秒。
GetTimelocal(1159233724,时,分,秒);执行后,得到的“时〞的值为9,“分〞的值为22,“秒〞的值为4。
HidePicture
此函数用于隐藏正在显示的画面,但并不将其从内存中删除。
调用格式:
HidePicture("画面名");
参数:
画面名称字符串型
例如:
HidePicture("反响车间");
HTConvertTime
此函数将
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 精心 整理 组态 常用命令 语言 函数 手册
![提示](https://static.bdocx.com/images/bang_tan.gif)