精心整理组态王常用命令语言函数速查手册文档格式.docx
《精心整理组态王常用命令语言函数速查手册文档格式.docx》由会员分享，可在线阅读，更多相关《精心整理组态王常用命令语言函数速查手册文档格式.docx（46页珍藏版）》请在冰点文库上搜索。
反三角函数的
此函数用于计算变量值的反余弦值，变量值的取值范围在[-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个。
当对报表的指定单元格区域内的单元格进行求平均值运算时，结果显示在当前单元格内，语法格式使用如下：
a2J;
任意单元格选择求平均值：
=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）;
从变量DDE的第6位得到变量开关”状态。
BitSet
此函数将一个整型或实型变量的任一位置为指定值（0或1）。
语法格式：
BitSet（Var,bitNo,OnOff）;
参数：
位的序号，取值1至16OnOff:
位的设定值
注意：
对于IO变量来说，BitSet函数只是用于可读可写的变量。
BitSet（DDE1,6,0）;
将变量DDE的第6位置为0。
ChangePasswordpassword['
pa?
sw?
d]n.密码；
口令
此函数显示更改口令”对话框，允许登录工程人员更改他们的口令。
使用格式：
ChangePassword（）;
为画面上某一按钮设置命令语言连接：
运行时单击此按钮，弹出对话框：
修改口令
因
旧口令P
新口令I
校验新口令I
确定取消
提示工程人员输入当前的口令和新口令以及验证新口令。
完全正确后，工程人员的口令设置为新值。
ClosePicture
此函数用于将已调入内存的画面关闭，并从内存中删除。
语法格式如下：
ClosePicture（”画面名"
ClosePicture（"
反应车间"
将关闭画面反应车
间”。
ConfigODBC
此函数用于配置odbc的数据源，语法格式如下：
ConfigODBC（nDatatbasetype,szAttributes）;
nDatatbasetype:
数据库类型，目前支持Access,SQLserver该参数为0时表示数据库类型为Access，参数为1时表示数据库类型为SQLserver;
szAttributes:
配置字符串：
例1:
配置Access数据库，DSN名称为demo2,数据库文件为
数据库.mdb。
ConfigODBC（0,"
DSN=demo2\0Description=E:
\Program
数据库.mdb\0PWD=1234\0UID=shihf"
例2:
配置SQ嗷据库：
ConfigODBC（1,"
DSN=MyDSN\0Description=SQLConfigDSNSample\0SERVER=MySQL\0ADDRESS=MyServer\0NETWORK=dbmssocn\0DATABASE=pubs\0”）;
Date
此函数为根据给出的年、月、日整型数，返回日期字符串，默认格式为：
年：
月：
日。
语法使用格式如下：
Date（LONGnYear,LONGnMonth,LONGnDay）;
年、月、日变量分别为：
$年”、$月”、$日”，用日期来显示由以上三个整数
决定的’日期”字符串，则在命令语言中输入：
日期=Date（年，月，日）；
DisplayMCI此函数提供了一个对多媒体设备的通用接口，具有强大的功能。
语法使用格式:
DisplayMCI（"
MClCommand"
option）;
下面举例说明此函数的使用方法。
DisplayMCI（PLAYCD,3）;
用于播放CD昌片中的第3支歌曲。
DisplayMCI（STOPCD”）'
；
用于停止播放CD>
DisplayMCI（PLAYMIDI'
”c:
\midi.mid”）;
用于播放MIDI格式的背景音
乐”c:
\midi.mid
DisplayMCI（
PAUSEMIDI,”c:
暂停播放MIDI格式的背景音
RESUMMIDL”c:
继续播放MIDI格式的背景音
CLOSEMIDI,”c:
停止播放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
对于设置了保存数值”和保存参数”的变量，使用该函数后，当变量的值和参数发生
变化时，系统会自动将变量的值和参数保存到文件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：
所要查询的变量的名称，类型为字符串型，即带引号。
数据查询的开始时间，该时间是通过组态王HTConvertTime函
数转化的以1969年12月31日16:
00为基准的长整型数，所以用户在使用本函数之前，应先将查询起始时间转换为长整型数值。
返回一个
实数值。
GetHistAveData
此函数用来获取某段时间中历史数据的平均值
RealResult=GetHistAveData（TagName,StartTime,EndTime）;
00为基准的长整型数，所以用户在使用本函数之前，应先将查询起始时间转换为长整型数值。
EndTime:
数据查询的结束时间，类型同StartTime。
GetHistMaxTime
此函数用来获取某段时间中历史数据的最大值对应的时间
RealResult=GetHistMaxTime（TagName,StartTime,EndTime）;
数据查询的开始时间，该时间是通过组态王HTConvertTime函数转化的以1969年12月31日16:
00为基准的长整型数，所以
用户在使用本函数之前，应先将查询起始时间转换为长整型数值。
数据查询的结束时间，类型同StartTime。
返回一个字符串，格式为2008/10/1011:
11:
11。
GetHistMinTime此函数用来获取某段时间中历史数据的最小值对应的时间
RealResult=GetHistMinTime（TagName,StartTime,EndTime）;
00为基准的长整型数，所以用户在使用本函
数之前，应先将查询起始时间转换为长整型数值。
返回一个字符串，格式为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）;
szStationName远程站点名称。
离散型，>
0正在备份数据=0空闲。
备份状态=GetStationStatus（IO采集站”）;
GetTime
此函数将以秒为单位的长整型数转换为相应的时间数值，分别以时、分、秒等的时间
数值输出。
00。
转换完成输出的时间也为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
此函数将以秒为单位的长整型数转换为相应的时间数值，分别以本地的时、分、秒的
时间数值输出。
该长整型秒数的基准为UTC脩林尼治）时间1970年1月1日00:
转换完成输出的时间为本地时间。
GetTimelocal（DateTime,Hour,Minute,Second）;
使用HTConvertTime函数将自UTC胳林尼治）时间1970年1月1日00:
4转换为以秒为单位的长整数数值为1159233724,使用
GetTimelocal函数可以从这个数值中分离出所表示的北京时间——时、分、秒。
GetTimelocal（1159233724,时，分秒）;
执行
升级会员 