PowerBuilder 扩充函数集 1.5 文档
HomePage URL : blacktea.126.com blacktea.soim.net
E-Mail : blacktea@88998.com
PowerBuilder 扩充函数集 提供了二十多个PB没有提供的函数，主要是以用户对象
(User Object) 方式封装了一些API函数及用C语言开发的几个外部函数。开发环境为PB
6.51和VC6。
PowerBuilder 扩充函数集 完全免费，包括用户对象的源码和C语言源码，你可以任意使用和修改，并可以放在其它网站上。如果你将其放在你的网站上，我希望能同时加入本站的链接。
一、应用相关函数
- 检测应用是否已经运行 : uf_Application_IsRunning
- 取应用所在的路径 : uf_Application_GetLocation
- 取应用的文件名 : uf_Application_GetFileName
二、磁盘驱动器相关函数
- 取有效的盘符 : uf_Disk_GetAvailable
- 取指定驱动器的类型 : uf_Disk_GetType
- 取光驱盘符 : uf_Disk_GetCDRom
- 取指定磁盘的卷标 : uf_Disk_GetVolumeName
- 取指定磁盘的序列号 : uf_Disk_GetSerialNumber
- 取指定磁盘的剩余空间 : uf_Disk_GetFreeSpace
- 判断指定的盘符是否有效 : uf_Disk_IsAvailable
三、目录相关函数
- 创建目录 : uf_Directory_Create
- 删除目录 : uf_Directory_Remove
- 判断目录是否有效 : uf_Directory_IsAvailable
- 取当前目录 : uf_Directory_GetCurrent
- 取Windows目录 : uf_Directory_GetWindows
- 取System目录 : uf_Directory_GetSystem
- 取临时目录 : uf_Directory_GetTemp
四、文件相关函数
- 拷贝文件 : uf_File_Copy
- 删除文件 : uf_File_Delete
- 移动文件 : uf_File_Move
- 文件更名 : uf_File_Rename
- 判断文件是否有效 : uf_File_IsAvailable
- 取文件时间 : uf_File_GetDateTime
- 取文件属性 : uf_File_GetAttributes
- 设置文件属性 : uf_File_SetAttributes
五、字符串相关函数
- 全部替换 : uf_String_ReplaceAll
- 右起查找 : uf_String_RightPos
六、其它函数
- 打印纸型设置 : uf_Printer_SetPaperSize
- 取系统登录用户名 : uf_System_GetLogonName
- 设置窗口居中 : uf_Window_Center
- 设置系统日期时间 : uf_System_SetDateTime
- 检测 IP 地址是否有效 : uf_Network_Ping
一、应用相关函数
- boolean uf_Application_IsRunning()
- 检测应用是否已经运行
参数 : 无
返回值 : boolean
- 已经运行 : TRUE
没有运行 : FALSE
- string uf_Application_GetLocation()
- 取应用所在的路径
参数 : 无
返回值 : string
- 成功 : 应用所在的路径
失败 : NULL (空值)
- string uf_Application_GetFileName()
- 取应用的文件名
参数 : 无
返回值 : string
- 成功 : 应用的文件名
失败 : NULL (空值)
二、磁盘驱动器相关函数
- string uf_Disk_GetAvailable()
- 取有效的盘符
参数 : 无
返回值 : string
- 包含有效盘符的字符串
- string uf_Disk_GetType(string as_RootPathName)
- 取指定驱动器的类型
参数 :
- string as_RootPathName : 盘符或包含盘符的目录名
- 返回值 : string
- 返回值 :
成功 :
- REMOVABLE : 可移动设备
FIXED : 硬盘
REMOTE : 网络映射盘
CDROM : 光驱
RAMDISK : 内存虚拟盘
- 失败 : NULL(空值)
- string uf_Disk_GetCDRom()
- 取光驱盘符
参数 : 无
返回值 : string
- 包含光驱盘符的字符串.如果没有找到光驱,返回空串(不是NULL);如果系统中安装了多个光驱,返回包括多个光驱盘符的字符串,如"FG"表示F盘和G盘都是光驱
- string uf_Disk_GetVolumeName(string as_RootPathName)
- 取指定磁盘的卷标
- 参数 :
- string as_RootPathName : 盘符或包含盘符的目录名
- 返回值 : string
- 成功 : 磁盘卷标
失败 : NULL(空值)
- string uf_Disk_GetSerialNumber(string as_RootPathName)
- 取指定磁盘的序列号
参数 :
- string as_RootPathName : 盘符或包含盘符的目录名
- 返回值 : string
- 成功 : 磁盘序列号
失败 : NULL(空值)
- real uf_Disk_GetFreeSpace(string as_RootPathName)
- 取指定磁盘的剩余空间
参数 :
- string as_RootPathName : 盘符或包含盘符的目录名
- 返回值 : real
- 成功 : 磁盘剩余空间
失败 : -1
- unsignedlong uf_Disk_IsAvailable(string as_RootPathName)
- 判断指定的盘符是否有效
参数 :
- string as_RootPathName : 盘符或包含盘符的目录名
- 返回值 : boolean
- 有效 : TRUE
无效 : FALSE
三、目录相关函数
- boolean uf_Directory_Create(string as_PathName)
- 创建目录
参数 :
- string as_PathName : 待创建目录名
- 返回值 : boolean
- 成功 : TRUE
失败 : FALSE
- boolean uf_Directory_Remove(string as_PathName)
- 删除目录
参数 :
- string as_PathName : 待删除目录名
- 返回值 : boolean
- 成功 : TRUE
失败 : FALSE
- boolean uf_Directory_IsAvailable(string as_PathName)
- 判断目录是否有效
参数 :
- string as_PathName : 待判断目录名
- 返回值 : boolean
- 有效 : TRUE
无效 : FALSE
- string uf_Directory_GetCurrent()
- 取当前目录
参数 : 无
- 返回值 : string
- 成功 : 当前目录
失败 : NULL(空值)
- string uf_Directory_GetWindows()
- 取Windows目录
参数 : 无
- 返回值 : string
- 成功 : Windows目录
失败 : NULL(空值)
- string uf_Directory_GetSystem()
- 取System目录
参数 : 无
- 返回值 : string
- 成功 : System目录
失败 : NULL(空值)
- string uf_Directory_GetTemp()
- 取临时目录
参数 : 无
- 返回值 : string
- 成功 : 临时目录
失败 : NULL(空值)
四、文件相关函数
- boolean uf_File_Copy(string as_ExistingFileName,string as_NewFileName[,boolean
ab_SecurityMode])
- 拷贝文件
参数 :
- string as_ExistingFileName : 源文件名
string as_NewFileName : 目标文件名
boolean ab_SecurityMode : 安全模式.为TRUE时,如果目标文件存在,将不覆盖目标文件,函数返回FALSE;为FALSE时,如果目标文件存在,将覆盖目标文件,即使目标文件有只读属性.此参数可以省略,缺省时默认为TRUE
- 返回值 : boolean
- 成功 : TRUE
失败 : FALSE
- boolean uf_File_Delete(string as_FileName[,boolean ab_SecurityMode])
- 删除文件
参数 :
- string as_FileName : 待删除文件名
boolean ab_SecurityMode : 安全模式.为TRUE时,如果待删除文件有只读属性,不进行删除,函数返回FALSE
(等同于PB中的FileDelete函数);为FALSE时,即使待删除文件具有只读属性,也进行删除.此参数可以省略,缺省时默认为TRUE
- 返回值 : boolean
- 成功 : TRUE
失败 : FALSE
- boolean uf_File_Move(string as_ExistingFileName,String as_NewFileName[,boolean
ab_SecurityMode])
- 移动文件
参数 :
- string as_ExistingFileName : 源文件名,必须包含绝对路径
string as_NewFileName : 目标路径或文件名
boolean ab_SecurityMode : 安全模式.为TRUE时,如果目标文件存在,将不覆盖目标文件,函数返回FALSE;为FALSE时,如果目标文件存在,将覆盖目标文件,即使目标文件有只读属性.此参数可以省略,缺省时默认为TRUE
- 返回值 : boolean
- 成功 : TRUE
失败 : FALSE
- boolean uf_File_Rename(string as_OldFileName,string as_NewFileName)
- 文件更名
参数 :
- string as_OldFileName : 原文件名
string as_NewFileName : 新文件名
- 返回值 : boolean
- 成功 : TRUE
失败 : FALSE
- boolean uf_File_IsAvailable(string as_FileName)
- 判断文件是否有效.有效是指1:文件名包含绝对路径;2:文件可以被打开
- 参数 :
- string as_FileName : 待判断文件名
- 返回值 : boolean
- 有效 : TRUE
无效 : FALSE
- datetime uf_File_GetDateTime(string as_FileName,unsignedinteger ai_Mode)
- 取文件时间
- 参数 :
- string as_FileName : 待取文件时间的文件名
- unsignedinteger ai_Mode : 取哪个时间
- 0:文件创建时间
- 1:最后访问时间
- 2:最后修改时间
- 返回值 : datetime
- 成功 : 文件时间
失败 : NULL(空值)
- string uf_File_GetAttributes(as_FileName)
- 取文件属性
- 参数 :
- string as_FileName : 待取文件属性的文件名
- 返回值 : string
- 成功 : 包含文件属性字符的字符串,其中
- R : 只读属性
H : 隐含属性
S : 系统属性
A : 归档属性
D : 文件名为一目录
- 失败 : NULL(空值)
- boolean uf_File_SetAttributes(string as_FileName,string as_FileAttributes)
- 设置文件属性
- 参数 :
- string as_FileName : 待设置文件属性的文件名
as_FileAttributes : 包含设置命令的字符串,其中
- R+ : 设置只读属性
R- : 去掉只读属性
H+ : 设置隐含属性
H- : 去掉隐含属性
S+ : 设置系统属性
S- : 去掉系统属性
A+ : 设置归档属性
A- : 去掉归档属性
- 返回值 : boolean
- 成功 : TRUE
失败 : FALSE
五、字符串相关函数
- string uf_String_ReplaceAll(string as_String1,string as_String2,string
as_String3)
- 全部替换
- 参数 :
- string as_String1 : 原始字符串
string as_String2 : 查找字符串
string as_String3 : 要替换成的字符串
- 返回值 : string
- 替换结果
- Long uf_String_RightPos(string as_String1,string as_String2,long
al_Start,boolean ab_OverEndPos)
- 右起查找
- 参数 :
- string as_String1 : 待进行查找字符串
string as_String2 : 要查找的被包含的字符串
long al_Start : 开始查找位置，如果此参数大于as_string1的长度或等于0，则从as_string1的最右边开始查找
boolean ab_OverEndPos : 是否查找跨越最右点(即开始查找位置)的字符串
- 返回值 : long
- 找到 : 找到的位置
没找到 : 0
六、其它函数
- boolean uf_Printer_SetPaperSize(unsignedinteger ai_Width,unsignedinteger
ai_Height,unsignedinteger ai_Orient)
- 打印纸型设置
- 参数 :
- unsignedinteger ai_Width : 纸张宽度，单位mm
unsignedinteger ai_Height : 纸张高度，单位mm
unsignedinteger ai_Orient : 方向，0 : 纵向；1 : 横向
- 返回值 : boolean
- 成功 : TRUE
失败 : FALSE
- string uf_System_GetLogonName()
- 取Windows登录用户名
- 参数 : 无
- 返回值 : string
- 成功 : Windows登录用户名
失败 : NULL(空值)
- (none) uf_Window_Center(window aw_Window)
- 设置窗口居中
- 参数 :
- window aw_Window : 待设置居中的窗口
- 返回值 : 无
- 成功 : Windows登录用户名
失败 : NULL(空值)
- boolean uf_System_SetDateTime(datetime adt_SystemDateTime)
- 设置系统日期时间
- 参数 :
- datetime adt_SystemDateTime : 待设置的日期和时间
- 返回值 : boolean
- 成功 : TRUE
失败 : FALSE
- boolean uf_Network_Ping(string as_IPAddr)
- 检测 IP 地址是否有效，即实现 Ping 功能
- 参数 :
- string as_IPAddr : 目标 IP 地址
- 返回值 : boolean
- 有效 : TRUE
无效 : FALSE