MCGS嵌入版运行环境操作函数

MCGS

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，策略名；

MCGS

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号运行策略的名称。

MCGS

!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的值。