首页

pb函数库之库管理函数

减小字体

增大字体作者：佚名来源：本站整理发布时间：2017-03-06 14:26:14

LibraryCreate()
功能创建一个空的PowerBuilder应用库，并可根据需要在创建应用库的同时添加库注解。
语法LibraryCreate ( libraryname{, comments } )
参数libraryname：string类型，指定要创建应用库的名称，可以带上路径，不带路径时在当前目录下创建应用库comments：string类型，可选项，指定要创建的应用库的注解返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，LibraryCreate()函数返回NULL。用法LibraryCreate()函数在指定路径下创建一个空的PowerBuilder应用库（PBL）。如果在指定应用库名称时没有指定文件的扩展名，那么该函数自动加上扩展名.PBL。
LibraryDelete()
功能删除应用库库文件或应用库中的数据窗口对象。
语法LibraryDelete ( libraryname{, objectname, objecttype } )
参数libraryname：string类型，指定库名，可以带上路径，不带路径时在系统搜索路径下查找应用库objectname：string类型，可选项，指定要从库中删除的数据窗口对象的名称objecttype：LibImportType类型，可选项，指定要删除对象的类型，目前仅支持ImportDataWindow!返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，LibraryDelete()函数返回NULL。
用法执行LibraryDelete()函数时，如果未指定后两个参数，那么该函数删除指定的应用库；如果指定了后两个参数，那么该函数删除指定应用库中指定的数据窗口对象。LibraryDelete()函数只能删除应用库中的数据窗口对象，如果想删除其它对象，那么只能在PowerBuilder开发环境中使用库管理画笔（Library Painter）来实现了。
LibraryDirectory()
功能得到应用库中指定对象的信息列表，内容包括对象名称、最近修改日期和时间、以及对象的注释。
语法LibraryDirectory ( libraryname, objecttype )
参数libraryname：string类型，指定PowerBuilder应用库的名称，如果名称中未指定路径，那么该函数根据操作系统标准的文件搜索路径查找指定文件objecttype：LibDirType枚举类型，指定希望函数列出的对象类型，有效取值请参看用法。返回值String。函数执行成功时返回一个字符串，每个对象占用一行，行中各信息之间使用Tab字符（~t）分隔。行中信息格式为：对象名~t修改日期/时间~t注释~n发生错误时函数返回空字符串（""）。如果任何参数的值为NULL，LibraryDirectory()函数返回NULL。
用法LibraryDirectory()函数的objecttype参数是个LibDirType枚举类型的量，其有效取值为：DirAll!得到所有对象的信息DirApplication!得到应用对象的信息DirDataWindow!得到所有数据窗口对象的信息DirFunction!得到所有函数对象的信息DirMenu!得到所有菜单对象的信息DirPipeline!得到所有数据管道对象的信息DirProject!得到工程对象的信息DirQuery!得到所有查询对象的信息DirStructure!得到所有结构对象的信息DirUserObject!得到所有用户对象的信息DirWindow!得到所有窗口对象的信息使用LibraryDirectory()函数得到指定对象的名称、修改日期/时间以及可能的注释后，应用程序既可以使用Pos()函数进行定位和字符串分割，也可以使用数据窗口的ImportString()函数将结果显示在数据窗口中。
LibraryExport()
功能从指定应用库中以对象的语法定义格式卸出对象。
语法LibraryExport ( libraryname, objectname, objecttype )
参数libraryname：string类型，指定要移出对象的应用库的名称，如果名称中未指定路径，那么该函数根据操作系统标准的文件搜索路径查找指定文件objectname：string类型，指定要移出对象的名称objecttype ：LibExportType枚举类型，指定要移出对象的类型，具体取值请参看用法返回值String。函数执行成功时返回指定对象的语法，该语法与使用库管理画笔（Library Painter）移出对象时的语法相同，区别在于LibraryExport()函数省略了移出语法的头部。如果发生错误，则函数返回空字符串（""）。如果任何参数的值为NULL，LibraryExport()函数返回NULL。
用法LibraryExport()的objecttype参数的可能取值为： ExportApplication!应用对象ExportDataWindow!数据窗口对象ExportFunction!函数对象ExportMenu!菜单对象ExportPipeline!数据管道对象ExportProject!工程对象ExportQuery!查询对象ExportStructure!结构对象ExportUserObject!用户对象ExportWindow!窗口对象
LibraryImport()
功能将以语法格式表示的数据窗口对象装入指定的应用库中。
语法LibraryImport(libraryname,objectname,objecttype,syntax,errors{,comments } )
参数libraryname：string类型，指定要移入对象的应用库的名称，如果名称中未指定路径，那么该函数根据操作系统标准的文件搜索路径查找指定文件objectname：string类型，指定要移入的数据窗口对象的名称 objecttype：LibImportType枚举类型，指定要移入对象的类型，目前该函数只支持ImportDataWindow!，表示只能向应用库中移入数据窗口对象syntax：string类型，指定要移入数据窗口对象的语法errors：string类型变量，用于在发生错误时保存出错信息comments：string类型，可选项，用于指定移入对象的注解返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，LibraryImport()函数返回NULL。
用法当应用程序在运行过程中动态创建数据窗口对象后，可以使用LibraryImport()函数把动态数据窗口对象的定义保存到应用库中，以后就可以直接使用该对象了。