MCGS系统内函数参考手册.docVIP

MCGS系统内部函数 MCGS内部为用户提供了一些常用的数学函数和对MCGS内部对象操作的函数。组态时，可在表达式中或用户脚本程序中直接使用这些函数。为了与其它名称相区别，系统内部函数的名称一律以“！ !CallBackSvr DatName 函数意义：调用后台对象 返 回 值：数值型，后台对象的值 参 数：DatName，对象名，数值型 实 例：X ！CallBackSvr（X）X 注 意：本函数在新版本MCGS系统内部，已经无效。为了保留与旧版本的兼容性，暂时保留。 !ChangeLoopStgy StgyName，n 返 回 值：数值型。返回值 0：调用正常； 0：调用不正常。 参 数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间 实 例：!ChangeLoopStgy 报警策略，5000 ，将报警策略的循环时间改为为5秒 !CloseAllWindow WndName 函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，关闭其他窗口。如果”WndName”为空串，则关闭所有窗口。 返 回 值：数值型。返回值： 0：调用正常； 0：调用不正常。 参 数：WndName， 用户窗口名，字符型。 实 例：!CloseAllWindow “工况图” ，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口 !CloseAllWindow “” ，关闭所有窗口。 !EnableStgy StgyName，n 返 回 值：数值型。返回值 0：调用正常； 0：调用不正常。 参 数：StgyName，策略名； n，数值型，为1时表示打开此策略，为0时表示关闭此策略。 实 例：!EnableStgy 报警策略，1 ， 打开报警策略； !EnableStgy 报警策略，0 ， 关闭报警策略，使报警策略无效 !GetDeviceName Index 函数意义：按设备顺序取到设备的名字。 返 回 值：字符型。调用成功返回设备名，调用失败时返回空字符串。 参 数：Index，数值型。 实 例：!GetDeviceName 0 ，取0号设备构件的名称。 !GetDeviceState DevName 函数意义：按设备名查询设备的状态。 返 回 值：数值型。 -1调用不正常。 1 设备处于正常的工作状态。 2 设备正在工作，但设备不正常。 3 设备处于停止工作状态，且设备正常。 4 设备处于停止状态，且设备有错。 参 数：DevName，设备名，字符型。 实 例：!GetDeviceState OmronPLC ，读取设备构件“OmronPLC”的当前工作状态。 !GetStgyName Index 函数意义：按运行策略的顺序获得各策略块的名字。 返 回 值：字符型。 参 数：Index，数值型。 实 例：!GetStgyName 0 ，取0号运行策略的名称。 !GetWindowName Index 函数意义：按用户窗口的顺序获得用户窗口的名字。 返 回 值：字符型。 参 数：Index， 数值型。 实 例：!GetWindowName 0 ，读取0号用户窗口的名称。 !GetWindowState WndName 函数意义：按照名字取得用户窗口的状态。 返 回 值：数值型。 返回0：用户窗口处于关闭状态。 返回1：用户窗口处于打开状态。 返回2：用户窗口处于隐藏状态。 参 数：WndName，用户窗口名称，字符型。 实 例：!GetWindowState 工况图 ，获得用户窗口“工况图”的状态 !SetActiveX Activename，n，str 函数意义：操作指定的动画构件， 向窗口中的ActiveX控件发出控件命令 返 回 值：无 参 数：Activename，字符型，控件名称，用“.”分割窗口名和控件名，如:窗口0.控件1表示在用户窗口“窗口0”中的名为“控件1”的控件。 n，数值型，命令类型，请填1； str，字符型，命令字符串，具体含义请参照控件帮助。 实 例：!SetActiveX “窗口0.控件0”,1,”start” ，启动窗口0的控件0开始工作。 !SetDevice DevName，DevOp，CmdStr 返 回 值：数值型。返回值： 0：调用正常； 0：调用不正常。 参 数：DevName，设备名，字符型； DevOp，设备操作码，数值型； CmdStr，设备命令字符串，只有当DevOp 6时CmdStr才有意义。 DevOp取值范围及相应含义： 1：启动设备开始工作。 2：停止设备的工作使其处于停止状态。 3：测试设备的工作状态。 4：启动设备工作一次。 5：改变设备的