精心整理组态王常用命令语言函数速查手册文档格式.docx
- 文档编号:22935566
- 上传时间:2023-02-06
- 格式:DOCX
- 页数:41
- 大小:52.17KB
精心整理组态王常用命令语言函数速查手册文档格式.docx
《精心整理组态王常用命令语言函数速查手册文档格式.docx》由会员分享,可在线阅读,更多相关《精心整理组态王常用命令语言函数速查手册文档格式.docx(41页珍藏版)》请在冰豆网上搜索。
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);
参数:
整型或实型变量
位的序号,取值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格式的背景音乐”c:
DisplayMCI(“RESUMMIDI”,”c:
继续播放MIDI格式的背景音乐”c:
DisplayMCI(“CLOSEMIDI”,”c:
停止播放MIDI格式的背景音乐”c:
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到北京时间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:
GetHistAveData
此函数用来获取某段时间中历史数据的平均值
RealResult=GetHistAveData(TagName,StartTime,EndTime);
EndTime:
GetHistMaxTime
此函数用来获取某段时间中历史数据的最大值对应的时间
RealResult=GetHistMaxTime(TagName,StartTime,EndTime);
数据查询的结束时间,类型同StartTime。
返回一个字符串,格式为2008/10/1011:
11:
11。
GetHistMinTime
此函数用来获取某段时间中历史数据的最小值对应的时间
RealResult=GetHistMinTime(TagName,StartTime,EndTime);
返回一个字符串,格式为2008/10/1011:
GetKey
此函数为获得组态王当前使用的加密锁的序列号。
语法使用格式KeyID=GetKey();
该函数没有任何参数。
返回值为字符串型。
GetProjectPath
此函数用于获取当前工程的路径。
GetProjectPath();
在组态王数据词典中定义内存字符串变量VarName:
VarName=GetProjectPath();
GetRealDBForBool
此函数用于获取变量的当前实时离散值。
GetRealDBForBool("
VarName"
VarName:
变量名称,字符串格式说明:
变量只能是离散量。
返回值为离散型。
bb=GetRealDBForBool("
原料油出料阀"
GetRealDBForFloat
此函数用于获取变量的当前实时模拟值。
GetRealDBForFloat("
变量名称,字符串格式说明:
变量只能是实型变量。
ff=GetRealDBForFloat("
原料油液位"
GetRealDBForInt
此函数用于获取变量的当前实时整型值。
GetRealDBForInt("
变量只能是整型变量。
ii=GetRealDBForInt("
水果"
GetRealDBForString
此函数用于获取变量的当前实时字符串型值。
GetRealDBForString("
变量只能是字符串型变量。
ss=GetRealDBForString("
记录日期"
GetStationStatus
此函数用于在组态王进行网络历史数据备份合并时获得备份的状态。
使用时需要通过命令语言调用来获得状态值。
BOOLGetStationStatus(strszStationName);
离散型,>
0正在备份数据=0空闲。
备份状态=GetStationStatus(“IO采集站”);
GetTime
此函数将以秒为单位的长整型数转换为相应的时间数值,分别以时、分、秒等的时间数值输出。
转换完成输出的时间也为UTC(格林尼治)时间。
GetTime(DateTime,Hour,Minute,Second);
需要进行时间转换的数,整型,为输入参数
Hour:
时,整型,转换后得到的数据,输出参数
Minute:
分,整型,转换后得到的数据,输出参数
Second:
秒,整型,转换后得到的数据,输出参数
自UTC(格林尼治)时间1970年1月1日00:
00到2003年8月8日0:
8:
9的秒的数值为1060301289,使用GetTime()函数可以从这个数值中分离出所表示的日期——时、分、秒。
函数GetTime(1060301289,时,分,秒);
执行后,得到的“时”的值为0,“分”的值为8,“秒”的值为9。
获得其中日期的函数为GetDate()。
GetTimelocal
此函数将以秒为单位的长整型数转换为相应的时间数值,分别以本地的时、分、秒的时间数值输出。
转换完成输出的时间为本地时间。
语法使用格式:
GetTimelocal(DateTime,Hour,Minute,Second);
参数描述
分,整型,转换后得到的数据,输出参数
使用HTConvertTime函数将自UTC(格林尼治)时间1
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 精心 整理 组态 常用命令 语言 函数 手册