力控组态软件ForceControl V7.0的设备操作函数

DeviceClose
语法DeviceClose (DeviceName, DataSourNo)
说明停止设备通讯
参数DeviceName：设备名称，类型为字符串常量或变量，该名称由I/O设备定义
时创建。
DataSourNo：为整型，为数据源序号，-1表示本地数据源。数据源序号与数
据源定义列表中所看到的顺序相同，序号从0开始。
示例DeviceClose (“MyDev1”,-1);//停止设备MyDev1

DeviceDialup
语法DeviceDialup(DeviceName, telenum, DataSourNo)
说明改变设备拨号号码
参数DeviceName：设备名称，类型为字符串常量或变量，该名称由I/O设备定义
时创建。
telenum：电话号码，类型为字符串常量或变量。
DataSourNo：为整型，为数据源序号，-1表示本地数据源。数据源序号与
数据源定义列表中所看到的顺序相同，序号从0开始。
示例DeviceDialup (“MyDev1”, “6756888”,-1);//启动设备MyDev1。
备注该函数用于动态切换I/O采集设备的拨号号码。

DeviceOpen
语法DeviceOpen (DeviceName, DeviceAddress, DataSourNo)
说明启动设备通讯，并将地址切换到由DeviceAddress参数所指定地址上。
参数DeviceName：设备名称，类型为字符串常量或变量，该名称由I/O设备定义
时创建。
DeviceAddress：设备地址，I/O设备的逻辑地址，类型为字符串常量或变
量。如果该项为空串””，意思是使用上次启动地址，如果没有启动过将使用
设备定义时指定的缺省地址。
DataSourNo：为整型，为数据源序号，-1表示本地数据源。数据源序号与数
据源定义列表中所看到的顺序相同，序号从0开始。
示例DeviceOpen (“MyDev1”, “”,-1);//启动设备MyDev1。
DeviceOpen (“MyDev1”, “1”.-1);//启动设备MyDev1，并将地址切换到1。
备注该函数用于动态切换I/O采集设备（如一个串口接多台设备，但是这些设备
不同时工作，或其数据不需要同时观看），或采集包（如该数据包数据变化
慢且不经常看的量）。

力控组态软件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 ();

力控组态软件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型，预留参数,可用于记录上次选择的变量名
备注因采用实时获取数据库变量方式，所以在第一次出现选择框时先进行变量
初始化。