1、组态王命令语言函数速查手册北京亚控科技发展有限公司1命令语言函数速查手册“组态王”支持使用内建的复杂函数，其中包括字符串函数、数学函数、系统函数、控件函数、报表函数及其他函数，下面依次介绍各个函数（函数名不区分大小写，按字母排序）：Abs此函数用于计算变量值的绝对值，使用格式如下：Abs(变量名或数值);返回值：整值或实型值；例如：Abs(14); 返回值为 14Abs(-7.5); 返回值为 7.5Abs(距离); 返回内存模拟变量“距离”的绝对值。Ack对变量进行报警确认，或对报警组进行报警确认。如果函数参数为变量名称，则只对该变量进行报警确认；如果函数参数为报警组名称，则确认所有属于该报
2、警组及其子报警组的变量。该函数的参数只能是变量名或报警组名，不可以为字符串变量。此函数常用于按钮命令语言，当发生报警时，用此函数进行报警确认，它将产生确认报警事件。调用格式：Ack(报警组名)； 或 Ack(变量名)；例如：Ack(全厂)； 或 Ack(反应罐液位)；组态王命令语言函数速查手册北京亚控科技发展有限公司2AckByTagName对变量进行报警确认。函数参数可以是一个字符串变量，也可以是一个表示变量名的字符串。调用格式：AckByTagName(“tag_name“);参数：tag_name：变量名。例如：AckByTagName (“本站点液位“);AckByTagName(Va
3、rname);其中 Varname 为字符串变量。AckByGroupName对报警组进行确认。调用格式：AckByGroupName( “station_name“, “group_name“ );station_name 为产生报警的 IO 服务器名，group_name 为报警组名。函数参数可以是字符串变量，也可以是表示 IO 服务器名或报警组名的字符串。例如：AckByGroupName (“PC1“,“报警组 1“);AckByGroupName (PCName, GroupName);/PCName, GroupName为字符串变量。ActivateApp此函数用于激活正在运行的窗
4、口应用程序，使之变为当前窗口。获得输入焦点。该函数也可配合函数 SendKeys 的使用。调用形式：ActivateApp(“ExeName”)；参数：ExeName 应用程序的执行文件名例如：组态王命令语言函数速查手册北京亚控科技发展有限公司3激活 Microsoft Word 的正确调用为：ActivateApp(“Word.exe“)；激活组态王：可使用 ActivateApp(“TouchVew.exe“)；ActiveXIsVisible此函数用于控制窗体控件隐含。调用形式：ActiveXIsVisible(“CtrlName“, nMode)；参数：CtrlName 控件名nMod
5、e 控制模式。nMode=0 时，控件隐含。例如：实现控件隐含的正确调用为：ActiveXIsVisible(“Ctrl10”, 0)；ArcCos此函数用于计算变量值的反余弦值, 变量值的取值范围在-1，1之间，否则函数返回值无效。调用格式：ArcCos(变量名或数值);返回值：整值或实型值；例如：ArcCos(1); 此函数返回值为 0ArcCos(temp); 此函数返回变量“temp”的反余弦值。ArcSin组态王命令语言函数速查手册北京亚控科技发展有限公司4此函数用于计算变量值的反正弦值, 变量值的取值范围在-1，1之间，否则函数返回值无效。调用格式：ArcSin(变量名或数值);返
6、回值：整值或实型值；例如：ArcSin(1); 此函数返回值为 90ArcSin(temp); 此函数返回变量“temp”的反正弦值。ArcTan此函数用于计算变量值的反正切值, 使用格式为：ArcTan(变量名或数值);返回值：整值或实型值；例如：ArcTan(1); 此函数返回值为 45ArcTan (temp); 此函数返回变量“temp”的反正切值。Average此函数为对指定的组态王报表表格的多个单元格求平均值，或求多个变量的平均值。语法格式使用如下：Average（a1,a2 ）; 或 Average(a1:a10);a1、a2为组态王单元格所在的行号列标，或整型或实型变量。其中参
7、数个数为 1-32 个。当对报表的指定单元格区域内的单元格进行求平均值运算时，结果显示在当前单元格内，语法格式使用如下：Average（a1,a2）;组态王命令语言函数速查手册北京亚控科技发展有限公司5例如：任意单元格选择求平均值:=Average（a1,b2,r10 ）;连续的单元格求平均值:=Average(b1:b10);或求变量的平均值：AverageValue= Average(lVar1,fVar1);BackUpHistData此函数为组态王网络中从 IO 服务器上下载历史数据记录到历史记录服务器。用户在历史记录服务器上调用该函数。函数的使用需要与组态王网络配置相配合，具体内容参
8、见组态王 6.53 使用手册中“历史库”一章。语法使用格式：BackupStationData (Str chMchinename, Long ftEndtime);参数：chMchinename 字符串型 为进行备份存储的 IO 服务器名ftEndtime 整型 为备份截止时间例如：/备份“IO 采集站”的历史数据，截至时间为当前：endTime=HTConvertTime($年,$月,$日,$时,$分,0);BackUpHistData(“IO 采集站“, endTime);Bit此函数用以取得一个整型或实型变量某一位的值(0 或 1)。用法：OnOff=Bit( Var , bitNo)
9、; /OnOff:离散变量参数：Var:整型或实型变量组态王命令语言函数速查手册北京亚控科技发展有限公司6bitNo:位的序号，取值 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 至 16O
10、nOff:位的设定值注意：对于 IO 变量来说，BitSet 函数只是用于可读可写的变量。例如：BitSet(DDE1,6,0); 将变量 DDE1 的第 6 位置为 0。ChangePassword此函数显示“更改口令”对话框，允许登录工程人员更改他们的口令。使用格式：ChangePassword();例如：为画面上某一按钮设置命令语言连接：组态王命令语言函数速查手册北京亚控科技发展有限公司7ChangePassword( );运行时单击此按钮，弹出对话框：提示工程人员输入当前的口令和新口令以及验证新口令。完全正确后，工程人员的口令设置为新值。chartAdd此函数用于在指定的棒图控件中增加
11、一个新的条形图。语法格式如下：chartAdd( “ControlName“, Value, “label“ );参数：ControlName：工程人员定义的棒图控件名称，可以为中文名或英文名。Value：设定条形图的初始值，整形数据, 实型数据。label：设定条形图的标签值，默认值=索引值 Index，Index的取值范围是 1-16。例如：chartAdd( “XYChart“, 1, “L6“ );此语句将在棒图控件 XYChart 中增加一个标签为 L6 的条形图，其初始值为 1。组态王命令语言函数速查手册北京亚控科技发展有限公司8chartClear此函数用于在指定的棒图控件中清除
12、所有的棒形图。语法格式如下：chartClear( “ControlName“ );参数：ControlName：工程人员定义的棒图控件名称，可以为中文名或英文名。例如：chartClear( “XYChart“ );此语句把棒图控件 XYChart 中的所有棒图清除。chartSetBarColor此函数用于在指定的棒图控件中设置饼图的颜色。条形图不可以。语法格式如下：chartSetBarColor( “ControlName“, barIndex,colorIndex );参数：ControlName：工程人员定义的棒图控件名称，可以为中文名或英文名。barIndex: 整型变量，表示条
13、形图索引号，用于设定指定的条形图，其取值范围为 0-15。colorIndex: 整型变量，表示条形图的颜色索引号，用于设置指定条形图的颜色，其取值范围为 0-15，颜色索引号和相应的颜色如下所示。颜色索引号 代表颜色 颜色索引号 代表颜色0 Default 8 Gray1 Blue 9 Light Blue2 Green 10 Light Green3 Cyan 11 Light Cyan组态王命令语言函数速查手册北京亚控科技发展有限公司94 Red 12 Light Red5 Magenta 13 Light Magenta6 Yellow 14 Light Yellow7 White 1
14、5 Bright White16 Black例如：chartSetBarColor( “XYChart“, 0, 1 );此语句将棒图控件 XYChart 中第一块饼图的颜色设为 blue（即兰色） 。chartSetBarColor( “XYChart“, 2, 4 );此语句将棒图控件 XYChart 中第三块饼图的颜色设为 red（即红色） 。chartSetValue此函数用于在指定的棒图控件中设定/修改索引值为 Index 的条形图的数据。语法格式如下：chartSetValue( “ControlName“, Index, Value );参数：ControlName：工程人员定义
15、的棒图控件名称，可以为中文名或英文名。Value：设定条形图的数据，整形数据, 实型数据。Index：条形图的标签值， ，Index 的取值范围是 0-15，组态王自动从 0 开始加 1，给每一个新增加的条形图由小到大设定标签值。例如：chartSetValue( “XYChart“,2, 30);此语句将在棒图控件 XYChart 中设定索引值为 2（第三条）的条形图的数据为 30。组态王命令语言函数速查手册北京亚控科技发展有限公司10ClosePicture此函数用于将已调入内存的画面关闭，并从内存中删除。语法格式如下：ClosePicture(“画面名“);例如：ClosePicture
16、(“反应车间“); 将关闭画面“反应车间” 。ConfigODBC此函数用于配置 odbc 的数据源，语法格式如下：ConfigODBC(nDatatbasetype, szAttributes);参数：nDatatbasetype：数据库类型，目前支持 Access，SQL server该参数为 0 时表示数据库类型为 Access，参数为 1 时表示数据库类型为 SQL server ；szAttributes：配置字符串:例 1：配置 Access 数据库，DSN 名称为 demo2，数据库文件为E:Program FilesKingviewExampleKingdemo1数据库.mdb
17、。ConfigODBC(0,“DSN=demo20Description=E:ProgramFilesKingviewExampleKingdemo1数据库.mdb0PWD=12340UID=shihf“);例 2：配置 SQL 数据库：ConfigODBC(1, “DSN=MyDSN0 Description =SQLConfigDSN组态王命令语言函数速查手册北京亚控科技发展有限公司11Sample0SERVER=MySQL0ADDRESS=MyServer0NETWORK=dbmssocn0DATABASE=pubs0“);Cos此函数用于计算变量值的余弦值, 语法格式如下：Cos(数值
18、或变量名);例如：Cos(90); 返回值为 0Cos(temp); 返回变量“temp”的余弦值。Date此函数为根据给出的年、月、日整型数，返回日期字符串，默认格式为：年：月：日。语法使用格式如下：Date（LONG nYear, LONG nMonth, LONG nDay）;例如：年、月、日变量分别为：“$年” 、 “$月” 、 “$日” ，用日期来显示由以上三个整数决定的“日期”字符串，则在命令语言中输入：日期=Date（年,月,日）;DisplayMCI此函数提供了一个对多媒体设备的通用接口，具有强大的功能。语法使用格式：DisplayMCI( “MCICommand“, opti
19、on );下面举例说明此函数的使用方法。例如：组态王命令语言函数速查手册北京亚控科技发展有限公司12DisplayMCI(“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”);
20、继续播放 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_Tag1 时，Str 的值为 OnMsg当 Discre
21、te_Tag0 时，Str 的值为 OffMsg例如：Str = Dtext(电源开关，“电源打开“,“电源关闭“);当电源开关1 时，Str 的值为“电源打开“组态王命令语言函数速查手册北京亚控科技发展有限公司13当电源开关0 时，Str 的值为“电源关闭“。EditUsers此函数常用于按钮的命令语言连接，功能是在画面程序运行中配置工程人员。调用形式：EditUsers( );为配置其他工程人员，当前工程人员的权限必须不小于 900。EnableNavigate此函数用于显示/关闭导航图。调用形式：EnableNavigate(is_enable);参数：is_enable，整型。0: i
22、s_enable 为 0 时，关闭导航图；1:is_enable 为 1 时，显示导航图。使用 EnableNavigate 函数关闭导航图后，除非使用该函数来显示导航图，否则无法显示导航图。例如：EnableNavigate(0); /关闭导航图EnableSaveTagValueToIniValueWhenValueChange对于设置了“保存数值”和“保存参数”的变量，使用该函数后，当变量的值和参数发生变化时，系统会自动将变量的值和参数保存到文件 tagname.db 中，无论组态王运行系统是否正常退出，再次运行后，将保存的变量值和变量参数作为变量的初始值和初始参数。“保存数值”和“保存
23、参数”的具体含义请参见组态王手册第七章 变量定义和管理 部分。调用形式：EnableSaveTagValueToIniValueWhenValueChange(is_enable);组态王命令语言函数速查手册北京亚控科技发展有限公司14参数：is_enable：整型变量或数值1：当变量的值和参数发生变化时，保存变量数值和参数。组态王运行系统退出，再次运行后，将保存的变量值和变量参数作为变量的初始值和初始参数。0：与组态王“保存数值”和“保存参数”实现的功能相同。例如：组态王开发系统数据词典中定义变量，设置“保存数值” 。执行函数：EnableSaveTagValueToIniValueWhen
24、ValueChange(1);该变量的值发生变化时，系统保存该变量的值。组态王运行系统退出，再次运行后，将保存的变量值作为变量的初始值。Exit此函数使组态王运行环境退出。调用形式：Exit(Option);参数：Option: 整型变量或数值0-退出当前程序；1-关机；2-重新启动 windows；Exp此函数返回指数函数 ex 的计算结果，使用格式如下：Exp(数值或变量名);例如：Exp(1); 返回 e1 的计算值 2.718Exp(temp); 计算 e 常量的 temp 次幂并返回计算结果。组态王命令语言函数速查手册北京亚控科技发展有限公司15FileCopy此函数复制一个源文件到
25、目的文件，它与 DOS 的 Copy 命令或者Windows 文件管理器中的 Copy 功能相似。调用格式：FileCopy( SourceFile，DestFile，DoneTag);参数 描述SourceFile 源文件名(包含完整的路径)。DestFile 目的文件(包含完整的路径)或目录名(参见下面的例如子)。DoneTag 该参数目前无效。用来报告复制过程进展情况的变量名称。此参数须是一个内存长整数或内存模拟型，随着复制过程的进行，该值从 0 变化到 100。返回值：成功返回 1；不能启动返回 0；出错返回-1；例如：Status=FileCopy(“C:*.TXT“, “C:BAC
26、KUP“, DoneTag);Status：一个将被写为 1、-1 或 0 的整型变量。FileCopy()函数在后台执行，这样它不会干扰组态王的运行。Status 表明的是复制过程是否已成功启动。一旦复制过程已成功启动，此过程成功结束，Status 被置为 1。若此过程结束前发生错误，则 Status 被置为-1。SourceFile 和 DestFile 一般为文件名。但用FileCopy() 函数复制单一文件时，目标文件名可以是一个目录，如：FileCopy(“C:DATA.TXT“, “C:BACKUP“, DoneTag);组态王命令语言函数速查手册北京亚控科技发展有限公司16将把文
27、件“DATA.TXT”复制到“C：”驱动器上一个叫做“BACKUP”的目录下。变量 Monctor 在复制完成后置为1。若 SourceFile 包含任何通配符的话，DestFile 必须是一个目录(而非文件名)，否则此函数将返回一个错误代码，如：FileCopy(“C:*.TXT“, “C:BACKUP“, DoneTag);将把 C 盘根目录下所有的.TXT 文件复制到 C：BACKUP 目录下。FileDelete此函数删除不需要或不想要的文件。调用格式：FileDelete(Filename);参数 描述Filename 要删除的文件名。若找到要删除的文件，并成功地删除，此函数将返回
28、1，否则此函数返回 0。例如：Status=FileDelete(“C:DATA.TXT“);若在 C:找到 “DATA.TXT“ 则 Status 等于 1, 未找到该文件则为 0。FileMove此函数与 FileCopy ()函数相似，但只是将文件从一个位置转移到另一个位置，而不是复制。调用格式：FileMove(SourceFile, DestFile, DoneTag);参数 描述组态王命令语言函数速查手册北京亚控科技发展有限公司17SourceFile 源文件名(包含完整的路径)DestFile 目的文件名(包含完整的路径)DoneTag 用来报告移动过程进展情况的变量名称。此参数
29、须是一个内存长整数或内存模拟型，随着转移过程的进行，该值从 0 变化到 100。返回值：成功返回 1；不能启动返回 0；出错返回-1；例如：Status=FileMove(“C:DATA.TXT“,“D:DATA.TXT“,Monitor);Status 是一个将被写为 1、-1 或 0 的整型变量。Monitor ：在数据词典中定义过的内存整数。FileMove() 函数在后台执行，这样它不会干扰“组态王”的运行。使用 DoneTag 是为了允许应用程序或工程人员监视转移操作的进展。用这种方法，在转移过程启动后可能发生的任何错误都能使工程人员察觉。 （此处用变量 Monitor监测）这与上述
30、返回的 Status 不同，Status 表明的是转移过程是否已成功启动。一旦转移过程已成功启动，Monitor 就会被赋值 0。随着转移过程的进行，该值不断增加。当此过程成功结束时达到 100，Status 被置为 1。若此过程结束前发生错误，Status 被置为-1。若源文件和目的文件位于同一驱动器上，此函数可以简单地更改此文件的目录参照表(计算机在此表中保存磁盘上的文件名和存储位置)，而不用实际转移任何数据。在这种情况下，不管此文件的大小，转移操作将会很快。若源文件和组态王命令语言函数速查手册北京亚控科技发展有限公司18目的文件位于不同的驱动器上，转移操作所费的时间将随文件的大小不同而不
31、同。这是因为数据必须由一个物理磁盘传送到另一物理磁盘上，如：FileMove(“C:DATA.TXT“,“C:BACKUPDATA.TXT“,Monitor);将把“C”驱动器上根目录下的名为“DATA.TXT 的文件转移到名为“BACKUP”的目录下，变量 Monitor 在转移完成后将被置为 1。此函数也可用于文件更名，只要源文件和目的文件指定了相同的目录，但不同的文件名，如：FileMove (“C:DATA.TXT“,“C:DATA.BAK“,Monitor);将把 C 盘根目录下文件“DATA.TXT”更名为“DATA.BAK”。变量 Monitor 在其完成后被置为 1。FileR
32、eadFields此函数从一个指定文件中读出 CSV(逗号分隔变量)记录。调用格式：FileReadFields(Filename,FileOffset,”StartTag”,NumberOfFields);参数 描述Filename 指定要读的文件。FileOffset 指定读此文件的起始位置。若为 1，则表明从头开始StartTag 指定第一个数据要写到的那个组态王变量的名称。此变量名必须以一个数字结尾(如MyTag1)。此参数必须是一个表明变量名的字符串(而非实际的变量本身)。所以，若变量叫做 MyTag1，就需要给出 MyTag1 或MyTag1.name，而不仅仅是 MyTag1。N
33、umberOfFields 指定要读的字段数目(此文件的每条记录中组态王命令语言函数速查手册北京亚控科技发展有限公司19以逗号隔开的字段的数目)。若 StartTag 为“MyTag1”而 NumberOfField 为 3，则有 3个字段从文件中读出并保存在 MyTag1、MyTag2 和 MyTag3 中。这些具有连续名字的变量必须先在组态王中创建，并可以属于不同的类型(整型，文字等等)。例如：若 C：DATAFILE.CSV 的第一行内容为：“This is text, 3.1416, 5”，调用函数BytePosition=FileReadFields(“C:DATAFILE.CSV“
34、,1,“MyTag1“, 3);将读出此行，并把“This is text“保存在 MyTag1 中，3.1416 保存在 MyTag2 中，5 保存在 MyTag3 中：此函数在读出之后返回新的字节位置。你可以在下次读时使用此返回值作为 FileOffset 的值，如：BytePosition=FileReadFields(c:DATAFILE.CSV“,FileOffset,“MyTag1“,3);注意:StartTag 两侧必须加引号。FileReadStr此函数从指定文件中读出一指定数目的字节(或一整行)。调用格式：FileReadStr(Filename,FileOffset,Str
35、_Tag,CharsToRead);参数 描述Filename 指定要读的文件。FileOffset 指定读此文件的起始位置。若为 1，则表明从头开始。Str_Tag 指定将从文件中读出的数据保存于何处。CharsToRead 指定要从文件中读出多少字节。为处理文本组态王命令语言函数速查手册北京亚控科技发展有限公司20文件，可将 CharsToRead 置为 0，函数从文件中一直读到下一个 LF(换行符)。此函数在读出之后返回新的字节位置。可以在下次读时使用此返回值作为 FileOffset 值。例如：FileReadStr (“C:DATAFILE.TXT“, 1, Str_Tag, 0);
36、文件“C：DATAFILE.TXT”的第一行将被读出并保存到Str_Tag 中。FileWriteFields此函数往指定文件写入 CSV(逗号分隔变量)记录。调用格式：FileWriteFields(Filename,FileOffset,”StartTag”,NumberOfFields);参数 描述Filename 指定要写的文件。若文件不存在，则创建它。FileOffset 指定写此文件的起始位置。若 FileOffset 为 0，此函数将写到文件末尾。若为 1，则写到开头。StartTag 指定第一个数据项的变量名称。此变量名必须以一个数字结尾(如 MyTag1)。此参数必须是一个表
37、明变量名的字符串(而非实际的变量本身)。比如，变量名为 MyTag1，就需要给出”MyTag1” （注意引号）或 MyTag1.name，而不仅仅是 MyTag1。NumberOfFields 指定要写的字段数目(此文件的每条记录中以逗号隔开的字段的字段数目)。此函数在写入之后返回新的字节位置。可以在下次调用函数时使用此返回值作为 FileOffset 值。若 StartTag 为“MyTag1” ，而 NumberOfFields 为 3，则有 3 个字段被写入文件中(写入的是 MyTag1、MyTag2 和 MyTag3)。这些具组态王命令语言函数速查手册北京亚控科技发展有限公司21有连续
38、名字的变量必须先在组态王中创建，并可以属于不同的类型(整型，字符串等等)。例如：将一行“This is text 3.1416，5”写到文件 C：DATAFILE.CSV的第一行中。 “This is text”是 MyTag1 的当前值，3.1416是 MyTag2 的当前值，5 是 MyTag3 的当前值。调用函数FileWriteFields (“C:DATAFILE.CSV“, 1, “MyTag1“,3);若将文本串 MyTag1 写到 C：DATAFILE.CSV 的末尾，调用函数FileWriteFields (“C:DATAFILE.CSV“, 0, “MyTag1“,3);S
39、tartTag 两侧必须加引号。FileWriteStr此函数往指定文件写入指定数目的字节(或一整行)。调用格式：FileWriteStr(Filename,FileOffset,String,LineFeed);参数 描述Filename 指定写入的文件。若文件不存在，则创建它。FileOffset 指定此文件的起始位置。若 FileOffset 为 0，此函数将写到文件末尾。若为 1，则写到开头String 指定要写入文件中的字符。LineFeed 规定是否在写操作之后添加换行。当写入一文本文件时，可以把 LineFeed 置为 1。此函数在写入后返回新的字节位置。你可以在下次写时将此返回
40、值当作 FileOffset() 函数的返回值来使用。组态王命令语言函数速查手册北京亚控科技发展有限公司22例如：将名为 MsgTag 的字符串变量写入文件 C:DATAFILE.TXT 的末尾。调用函数：FileWriteStr (“C:DATAFILE.TXT“, 0, MsgTag, 1);GetBackupProgress此函数用于在组态王进行网络历史数据备份合并时获得进度百分比。使用时需要通过命令语言调用来获得进度值。语法使用格式：GetBackupProgress( str szStationName);参数：szStationName 远程站点名称。返回值：整型，为 0100 间
41、的进度值。例如：备份进度= GetBackupProgress(“IO 采集站”);GetDate此函数将以秒为单位的长整型数转换为相应的日期数值，分别以年、月、日等的日期数值输出。该长整型秒数的基准为 UTC(格林尼治)时间 1970 年 1 月 1 日 00:00:00。转换完成输出的日期也为 UTC(格林尼治)日期。语法使用格式GetDate(DateTime,Year,Month,Day);参数 描述DateTime： 需要进行日期转换的数，整型，为输入参数Year： 年，整型，转换后得到的数据，输出参数Month： 月，整型，转换后得到的数据，输出参数Day： 日，整型，转换后得到的
42、数据，输出参数组态王命令语言函数速查手册北京亚控科技发展有限公司23例如：自 UTC(格林尼治)时间 1970 年 1 月 1 日 00:00:00 到 2003 年8 月 8 日 0:8:9 的秒的数值为 1060301289，使用 GetDate()函数可以从这个数值中分离出所表示的日期年、月、日。函数 GetDate(1060301289,年,月,日); 执行后，得到的“年”的值为 2003， “月” 的值为 8， “日” 的值为 8。获得其中时间的函数为 GetTime()。GetDatelocal此函数将以秒为单位的长整型数转换为相应的日期数值，分别以年、月、日的日期数值输出。该长整
43、型秒数的基准为 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 转换
44、为以秒为单位的长整数数值为 1159233724，使用GetDatelocal 函数可以从这个数值中分离出所表示的北京日期年、月、日。GetDatelocal (1159233724,年,月,日);执行后，得到的“年”的值为 2006， “月” 的值为 9， “日”的值为 26。组态王命令语言函数速查手册北京亚控科技发展有限公司24GetGroupName此函数为通过报警组 ID 号获得报警组名称。在组态王中，每个报警组除了名称外，还有 ID 号。组态王的变量域“.Group”显示的是变量所属报警组的 ID 号，如果要获得相应的报警组名称，就需要使用该函数。语法使用格式sGroupName=
45、GetGroupName(StationName,GroupID);参数 描述StationName： 报警组所在的站点名称（该项暂时无效，使用时用空字符串代替）GroupID： 要获取名称的报警组的 ID 号返回值为字符串型。例如：GroupName=GetGroupName(“”, 本站点原料罐液位.Group);GetKey此函数为获得组态王当前使用的加密锁的序列号。语法使用格式KeyID=GetKey();该函数没有任何参数。返回值为字符串型。GetPictureScrollXPos此函数用于获取目标画面当前窗口的左上角的 X 坐标值。语法使用格式GetPictureScrollXPo
46、s(STRING PictureName);参数 描述PictureName：画面名称组态王命令语言函数速查手册北京亚控科技发展有限公司25返回值为目标画面当前窗口的左上角的 X 坐标值。例如：xx=GetPictureScrollXPos(“监控中心“);GetPictureScrollYPos此函数用于获取目标画面当前窗口的左上角的 Y 坐标值。语法使用格式GetPictureScrollYPos(STRING PictureName);参数 描述PictureName：画面名称返回值为目标画面当前窗口的左上角的 Y 坐标值。例如：yy=GetPictureScrollYPos (“监控中
47、心“);GetProjectPath此函数用于获取当前工程的路径。语法使用格式GetProjectPath();例如：在组态王数据词典中定义内存字符串变量 VarName：VarName=GetProjectPath();GetRealDBForBool此函数用于获取变量的当前实时离散值。语法使用格式GetRealDBForBool( “VarName“);参数 描述组态王命令语言函数速查手册北京亚控科技发展有限公司26VarName：变量名称，字符串格式说明：变量只能是离散量。返回值为离散型。例如：bb= GetRealDBForBool( “原料油出料阀“);GetRealDBForFlo
48、at此函数用于获取变量的当前实时模拟值。语法使用格式GetRealDBForFloat (“VarName“);参数 描述VarName： 变量名称，字符串格式说明：变量只能是实型变量。例如：ff= GetRealDBForFloat ( “原料油液位“);GetRealDBForInt此函数用于获取变量的当前实时整型值。语法使用格式GetRealDBForInt ( “VarName“);参数 描述VarName： 变量名称，字符串格式说明：变量只能是整型变量。例如：ii= GetRealDBForInt ( “水果“);组态王命令语言函数速查手册北京亚控科技发展有限公司27GetRealD
49、BForString此函数用于获取变量的当前实时字符串型值。语法使用格式GetRealDBForString ( “VarName“);参数 描述VarName： 变量名称，字符串格式说明：变量只能是字符串型变量。例如：ss= GetRealDBForString ( “记录日期“);GetStationStatus此函数用于在组态王进行网络历史数据备份合并时获得备份的状态。使用时需要通过命令语言调用来获得状态值。语法使用格式：BOOL GetStationStatus( str szStationName);参数：szStationName 远程站点名称。返回值：离散型， 0 正在备份数据 =0 空闲。例如：备份状态= GetStationStatus (“IO 采集站”);GetTime此函数将以秒为单位的长整型数转换为相应的时间数值，分别以时、分、秒等的时间数值输出。该长整型秒数的基准为 UTC(格林尼治)时间 1970 年 1 月 1 日 00:00:00。转换完成输出的时间也为 UTC(格林尼治)时间。语法使用格式GetTime(Dat
