MCGS系统内部函数参考手册范本.doc

《MCGS系统内部函数详解》 MCGS（Monitor and Control for General System）系统提供了一系列内部函数，方便用户在组态过程中实现复杂的控制逻辑和数据处理。这些函数以“！”符号开头，以便与其他变量和对象区分。以下将详细介绍部分关键函数的用途和使用方法。 1. **!CallBackSvr(DatName)**：调用后台对象。此函数用于获取后台对象的值，返回值是后台对象的数值。参数`DatName`是对象的名称。例如，`X=！CallBackSvr(X)`将后台对象X的值赋给变量X。请注意，此函数在新版本的MCGS中已无效，但为了兼容旧版本而保留。 2. **!ChangeLoopStgy(StgyName, n)**：更改循环策略的循环时间。此函数可以设置某个策略（如报警策略）的循环间隔，返回值表示调用是否成功。`StgyName`是策略的名称，`n`是毫秒数，表示新的循环时间。例如，`!ChangeLoopStgy(报警策略，5000)`将报警策略的循环时间设为5秒。 3. **!CloseAllWindow(WndName)**：管理用户窗口。根据参数`WndName`，此函数可以关闭所有窗口或指定窗口。如果`WndName`为空字符串，会关闭所有窗口。例如，`!CloseAllWindow(“工况图”)`将关闭除“工况图”之外的所有窗口。 4. **!EnableStgy(StgyName, n)**：开启或关闭策略。`StgyName`是策略名称，`n`为1表示开启，0表示关闭。例如，`!EnableStgy(报警策略，1)`将启用报警策略，`!EnableStgy(报警策略，0)`则会禁用。 5. **!GetDeviceName(Index)**：获取设备名称。此函数返回指定索引的设备名称，`Index`为设备顺序号。例如，`!GetDeviceName(0)`将获取第一个设备的名称。 6. **!GetDeviceState(DevName)**：检查设备状态。`DevName`是设备名称，返回值表示设备的工作状态，如正常、异常、停止等。例如，`!GetDeviceState( OmronPLC)`可以读取名为“OmronPLC”设备的当前状态。 7. **!GetStgyName(Index)**：获取策略名称。此函数返回按顺序排列的策略块的名称，`Index`为策略编号。例如，`!GetStgyName(0)`可以获取第一个运行策略的名称。 8. **!GetWindowName(Index)**：获取用户窗口名称。`Index`为用户窗口的顺序号，函数返回对应窗口的名称。如`!GetWindowName(0)`将返回第一个用户窗口的名称。 9. **!GetWindowState(WndName)**：查询用户窗口状态。返回值表示窗口是否打开、关闭或隐藏，`WndName`是窗口名称。例如，`!GetWindowState(工况图)`可得知“工况图”窗口的状态。 10. **!SetActiveX(Activename, n, str)**：控制ActiveX控件。`Activename`是控件的全名，包括窗口名和控件名，`n`是命令类型，`str`是命令字符串。如`!SetActiveX(“窗口 0.控件 0”，1，“start”)`将启动“窗口 0”中的“控件 0”。 11. **!SetDevice(DevName, DevOp, CmdStr)**：对设备进行操作。`DevName`是设备名，`DevOp`是设备操作码，`CmdStr`是设备命令字符串。不同的`DevOp`值对应不同的操作，如启动设备（1）或停止设备（2）。 以上仅为MCGS系统部分内部函数的简要介绍，实际使用中还涉及更多功能和细节，用户应结合具体需求和MCGS的完整文档来灵活应用这些函数，以实现更高效、精确的控制系统设计。