MCGS 内部函数运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时间。返 回 值：数值型。返回值=0：调用正常，0：调用不正常。参 数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间。实 例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为 5秒。!CloseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，关闭其他窗口。如果”WndName” 为空串，则关闭所有窗口。返 回 值：数值型。返回值：=0：调用正常。0：调用不正常。参 数：WndName ， 用户窗口名，字符型。实 例：!CloseAllWindow( 工况图)，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloseAllWindow( )，关闭所有窗口。!CloseAllSubWnd()函数意义：关闭窗口中的所有子窗口。返 回 值：浮点型，=0 为操作。实 例：!CloseAllSubWnd() ，关闭当前窗口的所有子窗口。!CloseSubWnd（WndName ）函数意义：关闭子窗口。返 回 值：浮点型，=1 为操作成功，1 为操作失败。参 数 值：WndName ：子窗口的名字。实 例：!CloseSubWnd( 窗口 1)，关闭子窗口“ 窗口 1”。!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。返 回 值：数值型。返回值=0：调用正常，0：调用不正常。参 数：SstgyName，策略名；n，数值型，为 1时表示打开此策略，为 0时表示关闭此策略。实 例：!EnableStgy(报警策略 ,1)， 打开报警策略；!EnableStgy(报警策略,0) ， 关闭报警策略，使报警策略无效。!GetDeviceName(Index)函数意义：按设备顺序取到设备的名字。返 回 值：字符型。调用成功返回设备名，调用失败时返回空字符串。参 数：Index，数值型。实 例：!GetDeviceName(0) ，取 0号设备构件的名称。!GetDeviceState(DevName)函数意义：按设备名查询设备的状态。返 回 值：数值型。=-1调用不正常。=1 设备处于正常的工作状态。=2 设备正在工作，但设备不正常。=3 设备处于停止工作状态，且设备正常。=4 设备处于停止状态，且设备有错。参 数：DevName ，设备名，字符型。实 例：!GetDeviceState(OmronPLC)，读取设备构件 “OmronPLC”的当前工作状态。注 意：设备名称是在设备构件基本属性页中设置的。!GetLastMouseActionTime()函数意义：获取最后一次鼠标的动作发生的时间。返 回 值：开关型。返回为 time_t 类型的时间值，可以在时间操作脚本函数中使用。参 数：无。实 例：在画面，系统对话框上的鼠标事件中添加!GetLastMouseActionTime()，获取鼠标最后动作时间。!GetStgyName(Index)函数意义：按运行策略的顺序获得各策略块的名字。返 回 值：字符型。参 数：Index，数值型。实 例：!GetStgyName(0)，取 0号运行策略的名称。!GetWindowName(Index)函数意义：按用户窗口的顺序获得用户窗口的名字。返 回 值：字符型。参 数：Index， 数值型。实 例：!GetWindowName(0) ，读取 0号用户窗口的名称。!GetWindowState(WndName)函数意义：按照名字取得用户窗口的状态。返 回 值：数值型。返回 0：用户窗口处于关闭状态。返回 1：用户窗口处于打开状态。返回 2：用户窗口处于隐藏状态。参 数：WndName ，用户窗口名称，字符型。实 例：!GetWindowState(工况图) ，获得用户窗口“工况图”的状态。!OpenSubWnd（参数 1,参数 2，参数 3，参数 4，参数 5，参数 6）函数意义：显示子窗口。返 回 值：字符型，如成功就返回子窗口 n，n 表示打开的第 n 个子窗口。参 数 值：参数 1：要打开的子窗口名。参数 2：整型，打开子窗口相对于本窗口的 X 坐标。参数 3：整型，打开子窗口相对于本窗口的 Y 坐标。参数 4：整型，打开子窗口的宽度。参数 5：整型，打开子窗口的高度。参数 6：整型，打开子窗口的类型。0位：是否模式打开，使用此功能，必须在此窗口中使用 CloseSubWnd 来关闭本子窗口，子窗口外别的构件对鼠标操作不响应1位：是否菜单模式，使用此功能，一旦在子窗口之外按下按钮，则子窗口关闭。2位：是否显示水平滚动条，使用此功能，可以显示水平滚动条3位：是否垂直显示滚动条，使用此功能，可以显示垂直滚动条4位：是否显示边框，选择此功能，在子窗口周围显示细黑线边框5位：是否自动跟踪显示子窗口，选择此功能，在当前鼠标位置上显示子窗口。此功能用于鼠标打开的子窗口，选用此功能则忽略 iLeft,iTop 的值，如果此时鼠标位于窗口之外，则在窗口对中显示子窗口6位：是否自动调整子窗口的宽度和高度为缺省值，使用此功能则忽略 iWidth和 iHeight 的值。子窗口的关闭办法：使用关闭窗口直接关闭，则把整个系统中使用到的此子窗口完全关闭使用指定窗口的 CloseSubWnd 关闭，可以使用 OpenSubWnd 返回的控件名，也可以直接指定子窗口关闭，此时只能关闭此窗口下的子窗口。!SetActiveX()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!CallBackSvr()函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!SetDevice(DevName,DevOp,CmdStr)函数意义：按照设备名字对设备进行操作。返 回 值：数值型。返回值：=0：调用正常。0：调用不正常。参 数：DevName，设备名，字符型；DevOp，设备操作码，数值型；CmdStr，设备命令字符串，只有当 DevOp=6 时 CmdStr 才有意义。DevOp 取值范围及相应含义：1：启动设备开始工作。2：停止设备的工作使其处于停止状态。3：测试设备的工作状态。4：启动设备工作一次。5：改变设备的工作周期，CmdStr 中包含新的工作周期，单位为 ms。6：执行指定的设备命令，CmdStr 中包含指定命令的格式。实 例：!SetDevice(OmronPLC,1, )，启动设备构件“OmronPLC” 开始工作。!SetMousePace(开关型)函数意义：设置鼠标灵敏度。参 数：开关型参数为每次按键消息需要设置的鼠标移动间隔，一般情况下请输入正整数，如果输入 0值表示禁止该功能实 例：!SetMousePace(1) ; 默认情况下该功能为关闭状态，鼠标灵敏度为 0，如果想启用该功能在启动策略中调用!SetMousePace 脚本函数指定步长值。 !SetNumPanelSize(Type,Size)函数意义：根据需要和显示屏的大小调整软键盘的大小。返 回 值：开关型。返回值=0：修改成功。新设置将在下一次打开输入键盘时生效。返回值=1：修改失败，参数错误。（可能是没有匹配的 type ，或者 size 参数超出范围）。参 数：Type，键盘类型，数值型；1：代表修改数值输入键盘。2：代表修改字符输入键盘；。3：代表修改用户登录对话框。Size，键盘大小，数值型；数值范围：200 像素1024 像素；实 例：!SetNumPanelSize(1,500)，将数值输入键盘改为 500*500大小，该正方形相对于屏幕居中。所有修改将在下一次打开输入框时生效，运行环境退出后，将自动保留上次输入框的大小。注意事项：键盘放大缩小功能在重新下载工程时没有删除配置文件，换工程后设置仍然有效，除非重新进行了设置。如果要去掉原来的设置则需要手工删除panelSize.ini 文件，该文件位于harddiskmcgsbin 目录下。 !SetStgy(StgyName)函数意义：执行 StgyName 指定的运行策略。返 回 值：数值型。返回值=0：调用正常，0：调用不正常。参 数：StgyName，策略名，字符型。实 例：!SetStgy(阀门关闭)，执行一次运行策略 “阀门关闭”。!SetWindow(WndName,Op)函数意义：按照名字操作用户窗口，如打开、关闭、打印。返 回 值：数值型。返回值：=0：调用正常。0：调用不正常。参 数：WndName ， 用户窗口名， 字符型。Op : 操作用户窗口的方法，数值型。Op=1：打开窗口并使其可见。Op=2：打开窗口并使其不可见。Op=3：关闭窗口。Op=4：打印窗口。Op=5：刷新窗口。实 例：!SetWindow(工况图 ,1)，打开用户窗口“工况图”，并使其可见。!SysWindow()函数意义：执行该函数后，打开用户窗口管理窗口，在管理窗口中可以选择打开或关闭指定的用户窗口。返 回 值：数值型。返回值=0：调用成功；0：调用失败。参 数：无。实 例：!SysWindow() 。!SetStyMode(StgyName)函数意义：通过脚本函数（位于系统函数-运行环境类）实现函数调用方式的策略调用。返回 值：开关型，返回值恒为 0。参 数：StgyName，策略名，字符型。实 例：!SetStgyMode(阀门关闭)，执行一次运行策略“阀门关闭”，“阀门关闭”策略执行完毕后，才返回调用者，调用者继续执行以下程序。!GetCurrentLanguageIndex( ) 函数意义：用于获取当前使用的语言的索引值。 返 回 值：开关型。返回值为语言项索引值。 索引值按照组态下拉框依次排序0，1，2 参 数： 无。 实 例：N=!GetCurrentLanguageIndex( ) ，其中 N为开关型变量 。 !SetCurrentLanguageIndex ( 开关型 ) 函数意义：通过索引项设定当前语言环境 返 回 值：开关型。返回值为 0表示执行成功，否则表示失败。 参 数：开关型。语言索引值。如果索引参数值超出当前选择语言范围，那么函数不生效。 实 例：!SetCurrentLanguageIndex(1)，表示设置当前语言为英文（选择语言为CH，EN）。 !GetLocalLanguageStr( 开关型 ) 函数意义：获得指定自定义 ID对应的当前语言的内容。 返 回 值：字符型。 参 数：开关型。自定义 ID索引值。如果无当前 ID对应自定义文本，则返回空值。实 例：!GetLocalLanguageStr（2），前提是有 ID为 2的自定义文本内容，如果当前语言为英文，则返回 ID为 2的自定义文本记录的英文内容。 !GetLanguageNameByIndex(开关型) 函数意义：根据语言索引值返回语言名称，返回值为字符型。 返 回 值：字符型，当前语言的名称。 参 数：开关型。语言的索引值。如果当前索引值无对应语言，则返回空值。 实 例：!GetLanguageNameByIndex(1) ，假如当前语言为中文、英文，则返回值为English。数据对象操作函数 !AnswerAlm(DatName)函数意义：应答数据对象 DatName 所产生的报警。如对应的数据对象没有报警产生或已经应答，则本函数无效。返 回 值：数值型，=0 为操作成功，0 为操作失败