MGCS命令函数Microsoft Word 文档(6) 下载本文

运行环境操作函数

!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中包含指定命令的格式。