发布时间 : 星期四 文章MCGS系统内部函数参考手册更新完毕开始阅读a9bdabd9998fcc22bcd10dd7
实 例：!Trim(\!Ucase(str)
函数意义：把字符型数据对象str的所有字符转换成大写。 返 回 值：字符型。 参 数：str， 字符型。
实 例：!UCase(\!Val(str)
函数意义：把数值类字符型数据对象str的值转换成数值。 返 回 值：数值型。 参 数：str， 字符型。 实 例：!Val(\
注 意：使用表签控件显示输出时，必需设置\小数位数\的个数；否则系统将以四舍五入的规则，显示输出整数数值。
定时器操作函数
定时器号：系统定时器的序号1—127，MCGS系统内嵌127个系统定时器。系统定时器以秒为定时单位。
!TimerClearOutput(定时器号)
函数意义: 断开定时器的数据输出连接
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：定时器号。
实 例：!TimerClearOutput(1)，断开1号定时器的数据输出连接 !TimerRun(定时器号)
函数意义：启动定时器开始工作
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：定时器号
实 例：!TimerRun(1)，启动1号定时器工作。 !TimerStop(定时器号) 函数意义：停止定时器工作
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：定时器号
实 例：!TimerStop(1 )，停止1号定时器工作。 !TimerSkip(定时器号，步长值)
函数意义：在计时器当前时间数上加/减指定值
17
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：定时器号；步长值
实 例：!TimerSkip(1，3)，1号定时器当前值+3 !TimerReset(定时器号，数值)
函数意义：设置定时器的当前值，由第二个参数设定，第二个参数可以是MCGS变量
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：定时器号；数值
实 例：!TimerReset(1，12)，设置1号定时器的值为12 !TimerValue(定时器号，0) 函数意义：取定时器的当前值
返 回 值：将定时器的值以数值型的方式输出（数值格式） 参 数：定时器号
实 例：Data3=!TimerValue(1，0)，取定时器1的值给Data3 !TimerStr(定时器号，转换类型)
函数意义：以时间类字符串的形式返回当前定时器的值
返 回 值：字符型变量， 将定时器的值以字符型的方式输出（时间格式） 参 数：定时器号 转换类型值：开关型
= 0：取定时器的值以“00：00”形式输出； = 1：取定时器的值以“00：00：00”形式输出； = 2：取定时器的值以“0 00：00：00”形式输出； = 3：取定时器的值以“0 00：00：00.000”形式输出；
实 例：Time=!TimerStr(1，1)，取定时器的值以“00：00：00”形式输出给Time !TimerState(定时器号)
函数意义：取定时器的工作状态
返 回 值：数值型变量，0 - 定时器停止，1 - 定时器运行 参 数：定时器号
实 例：data1=!TimerState(1)，取定时器1的工作状态给data1 !TimerSetLimit(定时器号，上限值，参数3)
函数意义：设置定时器的最大值，即设置定时器的上限 返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。
参 数：定时器号；上限值；参数3，1 - 表示运行到60后停止；0 - 表示运行到60后重新循环运行
18
实 例：!TimerSetLimit(1，60，1)，设置1号定时器的上限为60，运行到60后停止。
!TimerSetOutput(定时器号，数值型变量)
函数意义：设置定时器的值输出连接的数值型变量
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：定时器号；数值型变量，定时器的值输出连接的数值型变量 实 例：!TimerSetOutput(1，Data0)，将1号定时器的数据连接到Data0 !TimerWaitFor(定时器号，数值)
函数意义：等待定时器工作到“数值”指定的值后，脚本程序才向下执行 返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：定时器号；数值， 等待定时器工作到指定的值
实 例：!TimerWaitFor(1，55)，等定时器工作到55秒后再执行其他操作
系统操作函数
!AppActive(Title)
函数意义：激活指定的应用程序。使用时一般先用!Shell函数启动指定的应用程序，然后用本函数激活应用程序，再用!SendKeys函数发送击键消息，控制应用程序的执行。
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。
参 数：Title，字符型，字符串表达式，所要激活的应用程序窗口的标题。 实 例：!Shell(\，6) ! AppActive(“Microsorft Excel – Book1”)
说 明：AppActivate 语句将焦点移动到命名的应用程序或窗口，但并不影响焦点是否最大化或最小化。当用户采取行动改变焦点或将窗口关闭时，就会将焦点从活动的应用程序窗口移动出去。可用 Shell 函数启动一个应用程序并设置窗口样式。在决定激活哪个应用程序时，将 title 与每一个运行中的应用程序的标题字符串进行比较。如果没有完全匹配，就激活任何这样的应用程序，其标题字符串以 title 开头。如果以 title 命名的应用程序有很多实例，则激活任意一个实例。 !Beep()
函数意义：发出嗡鸣声。
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：无。 实 例：!Beep()
19
!EnableDDEConnection(DatName,n) 函数意义：启动/停止数据对象的DDE连接。
返 回 值：数值型。返回值=0：调用失败；<>0:调用成功。 参 数：DatName，数据对象名；
n，数值型，为1时表示启动数据对象的DDE连接。为0时则停止数据对象的DDE连接。
实 例：!EnableDDEConnection(温度，1)，启动数据对象“温度”的DDE连接。 !EnableDDEInput(DatName,n)
函数意义：启动/停止数据对象的DDE连接时外部数值的输入。 返 回 值：数值型。返回值=0：调用成功；<>0:调用失败。 参 数：DatName,数据对象名；
n，数值型，为1时表示启动数据对象的DDE连接，接收外部数值的输入。为0时则停止数据对象的DDE连接过程中外部数值的输入。
实 例：!EnableDDEConnection(压力，1)，启动数据对象“压力”的DDE连接，接收外部数值的输入。
!EnableDDEOutput (DatName,n)
函数意义：启动/停止数据对象的DDE连接时向外部输出数值。 返 回 值：数值型。返回值=0：调用成功；<>0:调用失败。 参 数：DatName,数据对象名；
n，数值型，为1时表示启动数据对象的DDE连接时向外部输出数值的功能。为0时则停止数据对象的DDE连接时向外部输出数值的功能。
实 例：!EnableDDEConnection(压力，1)，启动数据对象“压力”通过 DDE连接向外部输出数值的功能。 !LinePrtOutput (str)
函数意义：输出到行式打印机。
返 回 值：数值型。返回值=0：调用成功；<>0:调用失败。 参 数：str，字符型。
实 例：!LinePrtOutput (“ABCDEFG”)，将字符串输出到行式打印机。 !PlaySound(SndFileName，Op) 函数意义：播放声音文件。
返 回 值：数值型。返回值=0：调用成功；<>0：调用失败。 参 数：SndFileName，字符型，声音文件的名字。 Op，开关型 = 0：停止播放。
20