力控组态软件的用户管理函数

力控组态软件ForceControl V7.0的用户管理函数

CheckSecurityArea
语法int CheckSecurityArea(CString SecurityArea)
说明检查指定安全区是否可以操作
参数SecurityArea:逗号分割开的安全区名字符串,一般是用SecurityAreaDlg得
到的用户设定的值。
返回值整型值,返回当前登录的用户是否可以对这些安全区中的某一个有操作
权限。如果有操作权限返回TRUE,否则返回FALSE

CheckUserPassword
语法int CheckUserPassword(CString csUserName,CString csPassword)
说明检查指定用户的密码。
参数csUserName: 用户名。
csPassword: 用户密码。
返回值int型
0:用户名密码正确。
1:密码错误。
2:该用户不具备这项权限或用户名不存在。

CheckUserPopedom
语法int CheckUserFuncPopedom(CString csUserName,int iFuncUID)
说明检查某用户是否具备某项功能权限。
参数csUserName: 用户名。
iFunUID: 功能权限的UID。
返回值int型
0:该用户具备此项权限。
1:该用户不具备这项权限或用户名不存在。

GetUserCount
语法int GetUserCount()
说明获得用户列表中的数量。(已注册的用户)
返回值整型。
示例KIND=GetUserCount();//返回注册用户的总数

GetUserListNode
语法CString GetUserListNode (int iListUserPosition)
说明按用户列表的位置,获得用户名。
参数iListUserPosition:用户列表中的节点序号。
返回值字符串型,如果用户名字符串为空,表示执行异常。

GetVarSecurityArea
语法GetVarSecurityArea(VarName)
说明得到指定变量对应的安全区名。
参数VarName:变量名。
返回值返回变量设定的安全区的名。
示例Tag2.Desc = GetVarSecurityArea(Tag1)//得到变量Tag1设定的安全区名
并放到变量Tag2.desc中。

Login
语法Login()
说明用户注册,调用该函数将出现用户注册对话框。

LoginEx
语法LoginEx(“UserName”,”Password”)
说明该函数直接使用用户名和密码不用弹出对话框直接登录,常用于用户自己组
态一个登录对话框的时候使用。
参数UserName:登录用户名
Password:登录密码
返回值整形,0表示失败, 1表示成功。
示例ret=LoginEx(“UserName”,”Password”);

Logout
语法Logout()
说明用户注消,调用该函数将出现用户注消对话框。

UserMan
语法UserMan ()
说明增加或删除用户。调用该函数时将出现一用户管理对话框,在该对话框
中,用户可以添加新的用户或删除已有用户。注意:只有权限为工程师级
以上的用户才能调出该用户管理对话框,并且其只能增加或删除比自己权
限低的用户。
示例UserMan();

UserPass
语法UserPass()
说明修改用户口令,调用该函数时将出现一用户口令修改对话框,在该对话框
中,用户可以改变当前已登陆用户的口令。。
参数无。
示例UserPass ();

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

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

SnapShotView
语法SnapShotView()
说明快照浏览,若不选择浏览文件,浏览窗口将自动顺序播放。

StartApp
语法StartApp(AppName)
说明启动应用程序,应用程序的名称和路径由AppName指定。
参数AppName:应用程序的名字和路径。
如果要在Web上启动某一程序或打开文档,必须手工将程序或
文档复制到应用下的Http子目录中。
返回值为应用程序标识,可以通过该标识向启动的程序发信,
也可以关闭该应用程序。
示例1)AppID = StartApp(“c:\windows\write.exe”);//启动画笔程序。
SendMessage(AppID, 273, 10001,0);//向用户发送消息。
StopApp(AppID);//关闭程序
2)StartApp(“MyPage.Htm”);
3)StartApp(“MyDoc.Doc”);

StopApp
语法StopApp(AppID)
说明关闭先前由StartApp函数启动的程序
参数AppID为应用程序标识,类型为整型,为由StartApp函数得到的返回值。
示例AppID = StartApp(“c:\windows\write.exe”); //启动画笔程序
StopApp(AppID);//关闭程序

StrFormat
语法StrFormat(格式控制,输出表列)
说明将一系列字符串组合起来形成一个新的字符串。
参数(1)“格式控制”是用双撇号括起来的字符串,也称“转换控制字符串”,
它包括两种信息:
① 格式说明:由“%”和格式字符组成,它的作用是将输出的数据转换为
指定的格式输出。
②普通字符,即需要原样输出的字符。
(2)“输出表列”是需要输出的一些数据,可以是表达式。
1.%d,%i:以带符号的十进制形式输出整数(整数不输出符号);
2.%o,%x:以八进制、十六进制无符号形式输出整数;
3. %u:以无符号十进制形式输出整数。
4. %c:以字符形式输出,只输出一个字符;
5. %s:表示输出字符串。
6. %-ms:表示输出占m列,如字符串本身长度大于m,将字符串向左靠,
右补空格。
7. %m.ns:表示输出占m列,只取字符串左端n个字符。这n个字符输出在m列
的右侧,左补空格。
8. %-m.ns:表示输出占m列,只取字符串左端n个字符。这n个字符输出在m
列的左侧,右补空格。
9. %f:表示以小数的形式输出,输出含有6个小数。%m.nf和%-m.nf的意义参
考%m.ns。
10.%f:表示以指数的形式输出实数。
11.%g:选用%f或%e格式中输出宽度较短的一种格式,不输出无意义的0.
示例#a.desc=StrFormat(“this is %d”,a.PV);//当a.PV=2时,则a.desc=”this is 2”。

StrTime
语法StrTime(time, format)
说明将整型时间转成字符串形式
参数time:自1970年1月1日零时逝去的秒数。如计算机时区选东八区,则为自1970
年1月1日8时逝去的秒数
Format:要转成的时间格式标识,规定如下:
0:yyyy/mm/dd hh:mm:ss
1:yyyy-mm-dd hh:mm:ss
2:yyyy年mm月dd日hh:mm:ss
示例StrTime(curtim, 0);//将整型变量curtim中的时间值转成字符串形式

TipDisp
语法TipDisp(Prompt,Delay,StayTime)
说明信息提示
参数Prompt:字符串常量或字符表达式。
Delay:延迟显示时间,即只有鼠标在对象上停留时间超过该值后,才会显
示提示信息。
StayTime:提示框逗留时间,超过该时间后,信息消失。
示例TipDisp(“This is reactor-R101″,500,3000);

VarSelect
语法VarSelect(intbDbOnly, intnType, string strOldVarName)
说明弹出变量选择对话框
参数bDbOnly:0表示可以选择,所有的变量
1表示只选择DB数据库内的变量;
nType:所选变量到类型:1-int,2-double,3-string;
strOldVarName:string型,预留参数,可用于记录上次选择的变量名
备注因采用实时获取数据库变量方式,所以在第一次出现选择框时先进行变量
初始化。

力控组态软件的系统函数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隐藏