力控组态软件的系统函数3

力控组态软件ForceControl V7.0的系统函数3

SendEvent
语法SendEvent(EventType,EventKind,”EventContent”,$UserName)
说明该函数用于向pLog程序发送一条事件记录。该函数可以发送系统事件和操
作事件.事件类型可以是,消息、报警、事件类型事件。
参数EventType:事件类型。参数类型:整形。0 表示系统产生;1 表示人为操
作产生,如:关闭程序,VIEW下置数据。
EventKind:事件性质。参数类型:整形。0 表示消息事件;1 表示报警事
件;2 表示错误事件;3 表示其它性质的事件。
EventContent:要发送的内容。字符串类型。
$UserName:为系统提供的登录的用户。可以自由指定为其它字符串类型的
用户名。
返回值整形,0表示成功。
示例ret=SendEvent(1,2,”测试操作记录”,$UserName);//在日志文件中记录一条错
误信息操作记录,记录内容为“测试操作记录”。

SendKey
语法SendKey(AppId,Title,”KeyDesc”)
说明该函数用于向指定的窗口发送即将击键消息,就像在该窗口中用键盘输入
信息一样。该函数与StartApp配合使用,让力控○R可以控制其它应用程序。
如启动某一程序,然后让其做某一动作,如执行一菜单命令。
参数AppID:为应用程序标识,类型为整型,为由StartApp函数得到的返回值。
Title:窗口标题,一般为程序最上面标题条中所显示的内容。用于准确指明
程序中指定的窗口,如果为空” “,则为该程序中所有窗口。KeyDesc为字
符串,表示一组键的序列。可以是多个键的组合。组合键间用“+”号分隔。
如“Alt+F+P”表示按下Alt键,然后按下F和P键。键代码如下(注意:代码
要写在引号内):
Space 空格
Backspace 回退
Break 终止
Caps Lock 大小写切换
Delelte 删除
End 末尾
Enter 回车
Esc 取消
Home 回头
Insert 插入
Page Up 上一页
Page Down 下一页
Print Screen 拷屏
Tab 制表键
Shift 上挡键
Ctrl 控制键
% 百分号
Alt Alt键
功能键:F1到F12代表功能键;字母或数字键直接用其值来代表。
示例SendKey(appid, “”,”A”);//按下字母‘A’键
SendKey(appid, “”,”Ctrl + A”); //按下Ctrl键后,再按下A键
SendKey(appid, “”,”F1″); //按下功能键F1
SendKey(appid, “win1″,”Shift + F1″); //按下shift键后,再按下F1键

ShowApp
语法ShowApp(AppID, Title,flag)
说明将AppID所指定的程序所在的窗口正常化,最小化,最大化,隐藏。
参数AppID:为应用程序标识,类型为整型,为由StartApp函数得到的返回值。
Title:窗口标题,一般为程序最上面标题条中所显示的内容。用于准确指明
程序中指定的窗口,如果为空” “,则为该程序中所有窗口。
Flag:显示标志,指定窗口如何显示。取值与意义如下:
0:隐藏窗口。
1:最小化窗口,并激活系统列表中的顶层窗口。
2:激活并显示窗口,如果该窗口最小化或最大化,窗口将恢复到最小化前
状态。
3:已当前的位置和大小显示窗口。
4:激活并最大化该窗口。
示例ShowApp(AppID, “”,0);//隐藏AppID所在程序中的所有窗口。
ShowApp(AppID, “实时数据库”,3);//显示窗口。

ShowNavigationMap
函数原型ShowNavigationMap(boolbshow)
函数描述显示隐藏漫游图
返回值void
参数bshow-1显示,0隐藏

 

力控组态软件的系统函数2

力控组态软件ForceControl V7.0的系统函数2

InfoResource
语法result=InfoResource(ResourceType)
说明返回系统的各种系统资源
参数1:返回系统可用物理内存字节数
2:返回系统物理内存字节总数
3:返回系统可用物理内存百分比
4:返回当前系统正在运行的任务数
示例InfoResource(1)//将返回51843027 {可用物理内存字节数}
InfoResource(2)//将返回267894784 {物理内存字节数}
InfoResource(3)//将返回55 {系统可用物理内存百分比为55%}
InfoResource(4)//将返回20 {系统正在运行的任务数}

IntTime
语法IntTime(time, format)
说明用来获得日期时间的年月日时分秒。
参数time:自1970年1月1日零时逝去的秒数。
format:要得到的时间格式标识。
0:年
1:月
2:日
3:时
4:分
5:秒
示例year = IntTime(curtim, 0);//将整型变量curtim中的时间值的年度赋值给
变量year。

IntoConfig
语法IntoConfig()
说明进入组态状态
LongTime
语法LongTime(String)
说明将字符串形式表示的时间转成整型数
参数String:要转换的字符格式的时间,类型为字符串常量、变量或字符串表
达式。时间格式规定如下:YYYY/MM/DD hh:mm:ss YYYY为年;MM
为月;DD为日;hh为时;mm为分;ss为秒
返回值为整型数表示的时间,该数值为自1970年1月1日零时逝去的秒数。如计算机
时区选择东八区则表示自1970年1月1日8时逝去的秒数
示例n = LongTime(“2002/1/8 16:50:00”)

IsWeb
语法IsWeb()
说明用于判断是否在浏览器上运行,可以用该值有选择的执行脚本。
返回值整型,1表示在浏览器上运行;否则运行在VIEW上。
示例IF (IsWeb() == 0) THEN
A1.pv = a1.pv + 1;
ENDIF

MsgBox
语法MsgBox(Message)
说明显示一提示框
参数Message:提示框的显示信息,为字符串常量或字符串表达式。
返回值为1:表示选择了“是”,0:表示选择了“否”。
示例MsgBox(“System Alarm”);
RTN = MsgBox(“System Alarm”);
MsgBox(“System Alarm”+aa);\\aa为字符型变量

PlaySound
语法PlaySound(WavName,flag)
说明播放一段由文件名WavName指定的音乐
参数WavName:Wav文件名。
flag:播放方式取值为0或1。0:代表异步;1:代表同步。
示例PlaySound(“Avi01”,0) //异步方式播放AVI文件Avi01

PostMessage
语法PostMessage(AppID,Msg,wparam,lparam)
说明该函数用于用于向指定的程序发送一条消息。
参数AppID:应用程序ID。参数类型:整形。
MSG:发送的消息号。参数类型:整形。
wparam:要发送的消息参数。整形。
lparam:要发送的消息参数。整形。
返回值整形,1表示成功。
示例ret=PostMessage(AppID,5555,0,0);

Rand
语法rand(number)
说明产生随机数
参数number为随机数的上界,下界为0。
示例Rand(100)//会产生0~100之间的随机数(不包括100)

ReachTime
语法ReachTime(hour,minute)
说明当时间到达后返回值为真,否则为假。hour小时值,取值为0~23,-1
表示任何一小时,minute分钟值,取值为0~59
示例IF (ReachTime(8,30)) THEN
BEEP(1);
ENDIF; //每天上午8时30分该函数取值为真,这时将发出一声。

力控组态软件的系统函数1

力控组态软件ForceControl V7.0的系统函数1

ActiveApp
语法ActiveApp(AppID)
说明把AppID所指定的程序所在的窗口置到最前面,并且该窗口将获得输
入焦点,即该窗口可接收键盘输入。
参数AppID为应用程序标识,类型为整型,为由StartApp函数得到的返回值。
示例ActiveApp(AppID)
Beep
语法beep(number)
说明蜂鸣器发出声音
参数number使用任何有效的数值表达式,来指定蜂鸣器响声。
-1,0:为两种报警声。
1~7:对应乐谱的中音1至7。
8~14:对应乐谱的高音1至7。
示例beep(-1); //标准报警声
ConvertTo
语法ConvertTo(MasterOrSlave)
说明双机热备状态切换函数
参数MasterOrSlave
0:由工作状态切换到备份状态
1:由备份状态切换到工作状态
示例ConvertTo(tag1.pv);//当tag1.pv的值为0时,由工作状态切换到备份状
态;当tag1.pv的值为1时,由备份状态切换到工作状态。
备注默认数据源之间切换有效

EventDisp
语法EventDisp()
说明系统事件包括程序起停信息,操作记录,系统错误信息等。
示例EventDisp()//调用该函数将出现一事件显示框。
Exit
语法Exit(code)
说明code取值为0,1,2,3,4。
0:表示退出程序。
1:表示窗口最小化。
2:表示退出所有程序。
3:表示重新启动系统。
4:表示关闭系统。
示例Exit(0);// 退出应用程序
FireEvent
语法FireEvent(/*int*/nEventID,/*double*/Param1,/*double*/Param2)
说明本函数用于客户在力控中响应某事件后通知web容器的方法,客户可
以在力控任意脚本中调用此方法触发事件,函数通过Id来区分事件,
通过两个double参数带过去必要的参数。
参数nEventID-int型,事件ID。web事件可以通过ID来区分,具体ID号用
户可自定义。
Param1/Param2-double型,参数1/2,用户web事件的参数。
返回值无。
示例FireEvent(1,12.2,22.4);
关联方法web客户端事件UserEvent(在力控DrawCom.OCX控件中)
GetAppPath
语法GetAppPath()
说明获取当前应用路径
返回值类型为字符串,完整的应用路径字符串。
示例StrPath = GetAppPath()
GetDataSourceStat
语法GetDataSourceStat(int DataSourceNo)
说明获取数据源状态
参数DataSourceNo 数据源序号,序号从0开始
返回值数据源状态-int型,int-bit0 0-当前连接主机,1-当前连接从机;bit1-当前链路
状态,0-链路通讯正常,1-链路连接失败;bit2-当前连接机是否备份态,
0-运行态,1-备份态。-1代表链路完全中断,主从均链路中断。
示例GetDataSourceStat(0)