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

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：整型，打开子窗口的高度。