mcgs函数指令教程

运行环境操作函数

!ChangeLoopStgy(StgyName,n)

函数意义：改变循环策略的循环时间。

返 回 值：数值型。返回值=0：调用正常，<>0：调用不正常。 参 数：StgyName，策略名；

n，数值型，以毫秒数表示循环策略的循环时间。

实 例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。

!CloseAllWindow(WndName)

函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这

个窗口，关闭其他窗口。如果”WndName”为空串，则关闭所有窗口。

返 回 值：数值型。返回值：=0：调用正常。<>0：调用不正常。 参 数：WndName， 用户窗口名，字符型。

实 例：!CloseAllWindow(\工况图\，关闭除了用户窗口“工况图”以外的其他

窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；

!CloseAllWindow(\，关闭所有窗口。

!CloseAllSubWnd()

函数意义：关闭窗口中的所有子窗口。 返 回 值：浮点型，=0为操作。

实 例：!CloseAllSubWnd() ，关闭

运行环境操作函数

!ChangeLoopStgy(StgyName,n)

函数意义：改变循环策略的循环时间。

返 回 值：数值型。返回值=0：调用正常，<>0：调用不正常。 参 数：StgyName，策略名；

n，数值型，以毫秒数表示循环策略的循环时间。

实 例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。

!CloseAllWindow(WndName)

函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这

个窗口，关闭其他窗口。如果”WndName”为空串，则关闭所有窗口。

返 回 值：数值型。返回值：=0：调用正常。<>0：调用不正常。 参 数：WndName， 用户窗口名，字符型。

实 例：!CloseAllWindow(\工况图\，关闭除了用户窗口“工况图”以外的其他

窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；

!CloseAllWindow(\，关闭所有窗口。

!CloseAllSubWnd()

函数意义：关闭窗口中的所有子窗口。 返 回 值：浮点型，=0为操作。

实 例：!CloseAllSubWnd() ，关闭

!TimeGetSpan(iTime1，iTime2)

函数意义：计算两个时间iTime1和iTime2之差； 返 回 值：开关型，两时间之差； 参 数：iTime1，开关型，时间值； iTime2，开关型，时间值；

实 例：!TimeGetSpan(iTime1,iTime2)

实例说明：计算两个时间iTime1和iTime2之差。

!TimeStr2I(strTime)

函数意义：将表示时间的字符串（YYYY/mm/DD HH:MM:SS）转换为时间值； 返 回 值：开关型，转换后的时间值；

参 数：strTime，字符型，以字符串型表示的时间 （必须是YYYY/mm/DD HH:MM:SS的格式）；

实 例：!TimeStr2I(“2001/1/1 3:15:28”)

实例说明：将表示时间的字符串“2001/1/1 3:15:28”转换为开关型的时间值。

!TimeI2Str(iTime，strFormat)

函数意义：将时间值转换为字符串表示的时间； 返 回 值：字符型，转换后的时间字符串；

参 数：iTime，开关型，时间值；（注意，这里只能用!TimeStr2I(strTime)转换出的时间值，否则将

www.3722.cn 中国最大的资料库下载 目 录 ?1?

目 录

第二部分 MCGS高级教程 ................................................................................... 1

第一讲 构造实时数据库 ................................................................................. 1

1.1 MCGS实时数据库的概述 .......................................................................... 1 1.2 数据对象的类型 .......................................................................................... 2 1.3 数据对象的定义 ...............................................................................

!ExportHisDataToCSV(文件名,组对象名,字段名,开始时间,结束时间,最大记录数,导出模式,导出参数,进度指示数据对象名,取消控制数据对象名)

函数意义：

1.导出指定组对象存盘数据，导出的条件包括：开始时间-结束时间，

最大导出总条数;

2.导出字段列表，组对象为MCGS_ALARM则表示导出报警历史数

据；

3.可指定导出文件名和路径，主要是U盘导出，可以追加方式也可覆

盖方式导出；

4.可显示导出过程进度情况； 5.可取消和中止长时间的导出过程；

6.导出格式为csv文件，导出的第一行为字段名字。

返 回 值：开关型。

返回1 指定组对象错误，可能组对象没有保存历史数据或者没有该

组对象

返回2 指定的时间格式错误 返回3 指定的无效的数据对象名 返回4 无效的导出模式

返回5 同时只能支持一个csv导出

参 数：

文件名：字符型，指定导出的文件绝对路径名，指定的第一级目录不能创

建，其子目录如果不存在则可以创建。这样避免U盘不存在时创建U盘目录。注意：第一级目录不能自动创建用户必须保证其存在；

组对象名：导出的组对象名字。

字段名：字符型，用逗号分隔的要导出的字段名，不需要指定

MCGS全中文工控组态软件初级教材i1i

初级教材

前言

随着计算机技术和网络技术的飞速发展，为工业自动化开辟了广阔的发展空间，用户可以方便快捷地组建优质高效的监控系统，并且通过采用远程监控及诊断、双机热备等先进技术，使系统更加安全可靠，在这方面，MCGS工控组态软件将为您提供强有力的软件支持。

MCGS全中文工业自动化控制组态软件（以下简称MCGS工控组态软件或MCGS）为用户建立全新的过程控制系统提供了一整套解决方案。MCGS工控组态软件是一套32位工控组态软件，可稳定运行于Windows95/98/NT/2000/Me操作系统，集动画显示、流程控制、数据采集、设备控制与输出、网络数据传输、双机热备、工程报表、历史数据与曲线等诸多强大功能于一身，并支持国内外众多数据采集与输出设备，广泛应用于石油、电力、化工、钢铁、矿山、冶金、机械、纺织、航天、建筑、材料、制冷、交通、通讯、食品、制造与加工业、水处理、环保、智能楼宇、实验室等多种工程领域。本书以一个工程实例对MCGS工控组态软件的特点与功能进行综合性描述。希望您能通过本书掌握MCGS工控组态软件的基本操作与用法，并引导您完成一个简单的工程组态工作。

如果本书中的内容有纰漏之处，我们谨向您表示诚挚的歉

MCGS全中文工控组态软件初级教材i1i

初级教材

前言

随着计算机技术和网络技术的飞速发展，为工业自动化开辟了广阔的发展空间，用户可以方便快捷地组建优质高效的监控系统，并且通过采用远程监控及诊断、双机热备等先进技术，使系统更加安全可靠，在这方面，MCGS工控组态软件将为您提供强有力的软件支持。

MCGS全中文工业自动化控制组态软件（以下简称MCGS工控组态软件或MCGS）为用户建立全新的过程控制系统提供了一整套解决方案。MCGS工控组态软件是一套32位工控组态软件，可稳定运行于Windows95/98/NT/2000/Me操作系统，集动画显示、流程控制、数据采集、设备控制与输出、网络数据传输、双机热备、工程报表、历史数据与曲线等诸多强大功能于一身，并支持国内外众多数据采集与输出设备，广泛应用于石油、电力、化工、钢铁、矿山、冶金、机械、纺织、航天、建筑、材料、制冷、交通、通讯、食品、制造与加工业、水处理、环保、智能楼宇、实验室等多种工程领域。本书以一个工程实例对MCGS工控组态软件的特点与功能进行综合性描述。希望您能通过本书掌握MCGS工控组态软件的基本操作与用法，并引导您完成一个简单的工程组态工作。

如果本书中的内容有纰漏之处，我们谨向您表示诚挚的歉

mcgs

mcgs

内容简介

本书主要介绍使用MCGS软件组态工程常用的几大功能：动画、报警、配方和多语言。共分为四章，第一章简单动画组态，详细介绍了旋转、移动、大小变化等常用动画形式的组态过程；第二章报警，通过例子列举了工程中最多见的报警形式；第三章配方，以面包配方为例，详细介绍了配方存储于PLC和配方存储于HMI两种模式的组态方法；第四章介绍MCGS嵌入版组态软件6.8版本中新增的多语言功能，及其具体的实现方法。

未经许可，不得以任何方式复制或抄袭本书之部分或全部内容。 版权所有，侵权必究。

本教程介绍mcgsTpc嵌入式一体化触摸屏和MCGS组态软件的简单应用，适合已经熟悉初级教程的朋友。

mcgsTpc系列教程：

《mcgsTpc初级教程》 北京昆仑通态自动化软件科技有限公司 《mcgsTpc中级教程》 北京昆仑通态自动化软件科技有限公司 《mcgsTpc高级教程》 北京昆仑通态自动化软件科技有限公司

高等教育教材：

《工控组态软件与PLC应用技术》 北京航空航天大学出版社

《组态软件控制技术》 清华大学出版社 北京交通大学出版社 《组态软件技术及应用》

MCGS内部函数

运行环境操作函数

!ChangeLoopStgy(StgyName,n)

函数意义：改变循环策略的循环时间。

返 回 值：数值型。返回值=0：调用正常，<>0：调用不正常。 参 数：StgyName，策略名；

n，数值型，以毫秒数表示循环策略的循环时间。

实 例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。

!CloseAllWindow(WndName)

函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗

口，关闭其他窗口。如果”WndName”为空串，则关闭所有窗口。

返 回 值：数值型。返回值：=0：调用正常。<>0：调用不正常。 参 数：WndName， 用户窗口名，字符型。

实 例：!CloseAllWindow(\工况图\，关闭除了用户窗口“工况图”以外的其他窗口，

若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口； !CloseAllWindow(\，关闭所有窗口。

!CloseAllSubWnd()

函数意义：关闭窗口中的所有子窗口。 返 回 值：浮点型，=0为操作。

实 例：!CloseAllSub

MCGS内部函数

运行环境操作函数

!ChangeLoopStgy(StgyName,n)

函数意义：改变循环策略的循环时间。

返 回 值：数值型。返回值=0：调用正常，<>0：调用不正常。 参 数：StgyName，策略名；

n，数值型，以毫秒数表示循环策略的循环时间。

实 例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。

!CloseAllWindow(WndName)

函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗

口，关闭其他窗口。如果”WndName”为空串，则关闭所有窗口。

返 回 值：数值型。返回值：=0：调用正常。<>0：调用不正常。 参 数：WndName， 用户窗口名，字符型。

实 例：!CloseAllWindow(\工况图\，关闭除了用户窗口“工况图”以外的其他窗口，

若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口； !CloseAllWindow(\，关闭所有窗口。

!CloseAllSubWnd()

函数意义：关闭窗口中的所有子窗口。 返 回 值：浮点型，=0为操作。

实 例：!CloseAllSub