力控组态软件ForceControl V7.0后台组件系统函数的控件方法
CreatePath(string strPath)
描述： 创建文件夹路径
返回值： void
参数： strPath- 要创建的文件夹路径 , 以 ‘\’ 符号结尾
示例： #SystemFunction.CreatePath(“c:\path1\”);// 在 c 盘下创建文件夹 path1
GetDiskSpace(string RootPathName,int nFlag)
描述： 获取指定磁盘的信息，包括该磁盘上的空闲空间大小，总大小，可用大小
返回值： int- 大小信息，单位是 M
参数： RootPathName-string，需要查询的磁盘的根路径名称，如 “C:\”
nFlag-int，查询标志位，指定返回的信息类型。
0：调用者可以使用的大小；
1：该驱动总大小；
2：该驱动上剩余的空间大小。
说明： 该函数给用户提供查询指定驱动盘信息功能。用户指定盘符根路径，和查询标志位即可
示例： nSpace = #SystemFunction.GetDiskSpace(“D:\”,0); 返回 D 盘可以使用的空间大小，赋给变量 nSpace.
GetIP(int nIndex)
描述： 获取对应适配器的 IP 地址
返回值： string 0- 失败 , 其他值 – 成功
参数： nIndex- 适配器索引号 , 如果只有一个网卡 , 一般为 0
说明： 执行方法获得 IP 地址
示例： #SystemFunction.SetIP(0)// 获取 IP 地址
关联方法： SetIP
GetNetGate(int nIndex)
描述： 获取对应适配器的网关
返回值： string 0- 失败 , 其他值 – 成功
参数： nIndex- 适配器索引号 , 如果只有一个网卡 , 一般为 0
说明： 执行方法获得网关
示例： #SystemFunction.GetNetGate(0)// 获取网关
关联方法： SetIP
GetNetMask(int nIndex)
描述： 获取对应适配器的子网掩码
返回值： string 0- 失败，其他值 – 成功
参数： nIndex- 适配器索引号，如果只有一个网卡，一般为 0
说明： 执行方法获得子网掩码
示例： #SystemFunction.GetNetMask(0)// 获取子网掩码
关联方法： SetIP
IsAppActive(string strExe)
描述： 判断一个应用程序的活动状态
返回值： nt 0- 未运行 ,1- 运行
参数： strExe- 应用程序
说明： 执行方法返回应用程序的活动状态
示例： #SystemFunction.IsAppActive(“excel.exe”)// 获取 excel.exe 的活动状态
MsgBox(CString strMsg,int nMsgType)
描述： 弹出提示对话框
返回值： 无
参数： strMsg 提示信息，nMsgType 消息类型
1 – 显示一个 i 图标，表示提示
2 – 显示一个惊叹号，表示警告
3 – 显示叉号图标，表示错误
4 – 显示问号图标，表示询问
说明： 弹出提示对话框，和 WINDOWS API 有相同的名子
示例： #SystemFunction.MsgBox(” 非法操作 !”, 2);// 弹出警告提示对话框
PathFileExist(string FileName)
描述： 判断一个文件或者路径是否存在
返回值： int 0- 不存在，1- 存在
参数： strExe- 应用程序
说明： 执行方法返回应用文件或者路径是否存在
示例： #SystemFunction.PathFileExist(“c:\b.txt”)// 判断 c 盘下是否有文件 a.txt
SelectColor()
描述： 选择颜色
返回值： int
参数： 无
说明： 返回所选颜色值
示例： #SystemFunction.SelectColor();// 返回所选颜色值
SelectFileName(CString strParam,int bOpen)
描述： 选择文件
返回值： string
参数： strParam- 过滤器，若不为空，如 “doc|txt”，则对话框文件类型可选 doc,txt 及所有文件，若为空，则对话框文件类型为所有文件 bOpen- 打开模式，0- 保存对话框，其他值 -打开对话框
说明 ： 返回选择的文件名称
示例： #SystemFunction.SelectFileName(“doc|txt”,1);// 弹出文件打开对话框 , 文件类型可选doc,txt 及所有文件
SelectFilePath(int bOpen)
描述： 选择文件的路径
返回值： string
参数： bOpen- 打开模式 0- 保存对话框，其他值 – 打开对话框
说明： 返回选择文件的绝对路径
示例： #SystemFunction.SelectFilePath(1);// 返回选择文件的绝对路径
SelectFolderPath()
描述： 选择文件夹的路径
返回值： string
参数： 无
说明： 返回选择文件夹的绝对路径
示例： #SystemFunction.SelectFolderPath();// 返回选择文件夹的绝对路径
SetIP(int nIndex,string strIPAddress,string strNetMask,string strNetGate)
描述： 设置对应适配器的 IP 地址 , 子网掩码 , 网关
返回值： string 0- 失败 , 其他值 – 成功
参数： nIndex- 适配器索引号 , 如果只有一个网卡 , 一般为 0
strIPAddress-IP 地址
strNetMask- 子网掩码
strNetGate- 网关
说明： 执行方法设置 IP 地址
示例： #SystemFunction.SetIP(0,”192.168.0.189″,”255.255.255.0″,”192.168.0.1″)// 设置IP 地址为 192.168.0.189, 子网掩码为 255.255.255.0, 网关为 192.168.0.1
关联方法： SetIP,GetNetMask,GetNetGate
SetSystemTime(int nYear, int nMonth, int nDay,int nHour, int nMinute, int nSecond, int nMilliseconds)
描述： 设置系统时间
返回值： int
参数： nYear 年
nMonth 月
nDay 日
nHour 小时
nMinute 分钟
nSecond 秒
nMilliseconds 毫秒
说明： 设置系统时间。
示例： #SystemFunction.SetSystemTime(2008,5,9,14,43,21,55);// 设置系统时间为 2008年 5 月 9 日 14 时 43 分 21 秒 55 毫秒