PFC
PowerBuilder基础类库
PFC（Powerbuilder Foundation Class,Powerbuilder基础类库）是PowerBuilder提供的一个类库。
快速入门
一、新建应用Aplication；
二、在应用中包含下列库文件：
PFCAPSRV.PBL
PFCDWSRV.PBL
PFCMAIN.PBL
PFCUTIL.PBL
PFCWNSRV.PBL
PFEAPSRV.PBL
PFEDWSRV.PBL
PFEMAIN.PBL
PFEUTIL.PBL
PFEWNSRV.PBL
可以在powerbuilder的pfc例子程序中拷贝。
三、在应用程序画笔中，定义一个全局变量gnv_app，类型为n_cst_appmanager
n_cst_appmanager gnv_app
变量名称一定要为gnv_app,PFC中的对象、函数、事件要求一个类型为n_cst_appmanager或从它继承过来的类型的名称为gnv_app的变量。
四、在应用程序画笔的脚本中，在OPEN事件中，建立这个全局变量，并且调用pfc_Open(commandline)事件
gnv_app = CREATE n_cst_appmanager
gnv_app.Event pfc_open(commandline)
五、在应用程序画笔的CLOSE脚本中，调用pfc_Close事件,并且删除gnv_app变量
gnv_app.Event pfc_Close（）
DESTROY gnv_app
六、在PFEAPSRV.PBL库文件中，找到并打开n_cst_appmanager用户对象，在n_cst_appmanager构造事件中，调用n_cst_appmanager的函数来初始化有关版本、公司名称和INI文件的实例变量。
在n_cst_appmanager的pfc_Open事件中,调用n_cst_appmanaer的函数来打开你想要的应用服务,然后，调用of_Splash函数显示一个Splash屏幕，然后，打开你的程序的最开始的窗口。
类型
主要分为以下几种类别:
Application services
Window services
DataWindow services
File services
Data/Time services
String-handling services
Platform services
Menu Services
Resize services
INI file services
Numerical services
SQL parsing services
Conversion services
详细解说
Services及对象详细解说
一.n_cst_AppManager应用程序类
1.类的详细定义
A.继承关系:
pfc_n_base : n_base : pfc_n_cst_appmanager : n_cst_appmanager
B.事件
事件ID 事件说明
Constructor 初始化一些实例变量
Destructor 消毁用户自定义对象
pfc_Exit 执行结束程序时的清理工作
pfc_Logon 在w_logon中的OK按钮中调用,返回1表示成功,-1表示失败
pfc_Open 相当于应用中的Open事件,可在此打开gnv_app中的多个服务
pfc_PreAbout 在函数of_About（）中调用,用来控制w_about窗口
pfc_PreLogonDlg 在函数of_LogonDlg（）中调用,用来控制w_Logon窗口
pfc_PreSplash 在函数of_Splash（）中调用,用来控制splash屏幕
pfc_SystemError 当有系统错误发生时调用
pfc_Close 关闭应用时调用
pfc_ConnectionBegin 与其它应用连接时调用
pfc_ConnectionEnd 断开其它应用的连接时调用
pfc_Idle 应用空闲时调用
C.函数
函数名称 功能说明
of_About（） 根据所设信息显示w_About窗口,返回1表示成功,-1表示失败
of_GetAppIniFile（） 返回is_AppIniFile的值
of_GetAppProperties(未知) 未知
of_GetAppKey（） 取得is_AppKey的值
of_GetCopyright（） 返回is_Copyright的值
of_GetFrame（） 返回当前的w_Frame类型的窗口对象
of_GetHelpFile（） 返回在线帮助文件名
of_GetLogo（） 返回is_Logo的值,为一BMP文件名
of_GetMicrohelp（） 返回微帮助是否能使用,能使用时返回TRUE,否则返回FALSE
of_GetUserid（） 取得用户名（is_UserId）
of_GetUserIniFile（） 取得用户配置文件名,即is_UserIniFile
of_GetUserKey（） 返回is_UserKey的值
of_GetVersion（） 取得程序的版本号,即is_Version
of_IsRegistryAvailable（） 确定注册表是否可用,在Windows 95及WindowsNT中返回TRUE,否则返回FALSE
of_LogonDlg（） 显示w_Logon窗口,并且调用pfc_Logon事件;返回1时表示成功,0表示取消,-1表示失败
of_SetAppIniFile（iniFileName） 设置is_AppIniFile的值
of_SetAppKey（RegistryKey） 设置is_AppKey的值
of_SetAppPreference(Boolean) 设置application preference service是否可用,1表示成功,-1表示失败;可通过inv_apppref变量来实现相关功能
of_SetCopyright（Copyright Information） 设置is_Copyright的值
of_SetDebug（Boolean） 设置Debugging Service是否可用,1表示成功,-1表示失败;可通过inv_Debug来实现相关功能
of_SetDwCache（Boolean） 设置Data Caching Service功能,1表示成功,-1表示失败;可通过inv_dwCache来实现相关功能
of_SetError（Boolean） 设置Error Service功能,1表示成功,-1表示失败;可通过inv_Error来实现相关功能
of_SetFrame（FrameWindow） 标记Frame窗口到iw_Frame变量,可在w_Frame类型的窗口的active事件中调用以设置当前激活Frame窗口
of_SetHelpFile（helpFileName） 设置帮助文件文件名,即is_HelpFile
of_SetLogo（LogoBMPFileName） 设置应用程序标志图标,即is_Logo
of_SetMicrohelp（Boolean） 设置微帮助是否可用
of_SetMRU（Boolean） 设置Most Recently User Object Service是否可用,通过inv_MRU来实现相关功能
of_SetSecurity（Boolean） 设置Security Service是否可用,通过inv_Security来实现相关功能
of_SetTrRegistration（Boolean） 设置Transaction Registration Service是否可用,通过inv_TrRegisrration来实现相关功能
of_SetUserId(UserId) 设置用户名,即is_userId
of_SetUserIniFile(IniFileName) 设置用户配置文件名,即is_UserIniFile
of_SetUserKey(RegistryKey) 设置用户注册键名,即is_UserKey
of_SetVersion(VersionInformation) 设置应用程序版本信息,即is_Version
of_Splash(Second) 显示Splash屏幕,参数为显示时间
2.用法
声名一类型为n_cst_AppManager的全局变量gnv_app
在应用的Open事件中建立此全局变量gnv_app = CREATE n_cst_AppManager
在应用的Open事件中调用pfc_Open（）事件gnv_app.EVENT pfc_Open(CommandLine)
在应用的Close事件中调用pfc_Close（）事件gnv_app.EVENT pfc_Close（）
在应用的Close事件中销毁gnv_app变量DESTROY gnv_app
在应用的ConnectionBegin事件中调用pfc_ConnectionBegin事件RETURN gnv_app.EVENT pfc_ConnectionBegin(userId,password,ConnectionString)
在应用的ConnectionEnd事件中调用pfc_ConnectionEnd事件gnv_app.EVENT pfc_connectionEnd（）
在应用的Idle事件中调用pfc_Idle事件gnv_app.EVENT pfc_Idle（）
在应用的SystemError事件中调用pfc_SystemError事件gnv_app.EVENT pfc_SystemError（）
在n_cst_AppManager类的Construction事件中，调用下列函数设置相关的信息of_SetAppIniFile,of_SetAppKey,of_SetUserKey,of_SetUserIniFile,of_SethelpFile,
of_SetVirsion,of_SetCopyright,of_SetLogo,of_SetMicrohelp
在n_cst_AppManager类的Construction事件中，调用下列函数设置应用程序服务是否可能
of_SetAppPreference(TRUE)
of_SetDebug(TRUE)
of_SetDwCache(TRUE)
of_SetMRU(TRUE)
of_SetError(TRUE)
of_SetTrRegistration(TRUE)
of_SetSecurity(TRUE)
在n_cst_Appmanager类的pfc_PreLogonDlg事件中设置登录次数anv_LogonAttrib.ii_LogonAttempts = 3
在n_cst_AppManager类的pfc_Logon事件中判断登录是否正确，正确返回SUCCESS否则返回FAILURE
在n_cst_Appmanager类的pfc_Open事件中设置相应服务的各自特性
在n_cst_Appmanager类的pfc_Open事件中打开最初始的应用程序窗口。
二.n_cst_AppPreference首选项服务类
应用程序服务类通过INI文件或是注册表来保存应用或是用户的一些信息,并可以在适当的时候(比如程序启动时)自动恢复所有保存了的信息项。这样，用户的使用程序时，可以直接进入上次进入时的环境，而不需要重新设置。
1.类的继承关系:pfc_n_base : n_base : pfc_n_cst_apppreference : n_cst_appPreference
2.类的成员函数(详细的调用说明请见PB的在线帮助)：
of_IsRestoreApp（） 确定是否已经恢复应用的信息
of_IsRestoreUser（） 确定是否已经恢复用户的信息
of_Restore（） 从INI文件或是注册表中恢复应用及用户的设置信息
of_RestoreApp（） 从INI文件或是注册表中恢复应用的设置信息
of_RestoreUser（） 从INI文件或是注册表中恢复用户的设置信息
of_Save（） 将应用及用户的设置信息保存到INI文件或是注册表中
of_SaveApp（） 将应用的设置信息保存到INI文件或是注册表中
of_SaveUser（） 将用户的设置信息保存到INI文件或是注册表中
of_SetAppIniFile（） 设置应用信息保存的INI文件名
of_SetAppKey（） 设置应用保存的注册表的键名
of_SetRequestor（） 通过本类关联到应用程序类
of_SetRestoreApp（） 设置是否对应用信息进行处理(保存和恢复)
of_SetRestoreUser（） 设置是否对用户信息进行处理(保存和恢复)
of_SetUserIniFile（） 设置用户信息保存的INI文件名
of_SetUserKey（） 设置用户信息保存的注册表键名
3.事件：
pfc_Close 在关闭程序时调用
pfc_Open 在打开程序时调用
4.用法：
可以对下列信息进行保存和恢复:
User key
MicroHelp
Help file
Version
Logo bitmap
Copyright notice
DDETimeOut property
DisplayName property
DWMessageTitle property
MicrohelpDefault property
RightToLeft property
ToolbarFrameTitle property
ToolbarPopMenuText property
ToolbarSheetTitle property
ToolbarUserControl property
ToolbarText property
ToolbarTips property
User ID
在应用程序类的构造事件中,调用this.of_SetAppPreference(TRUE)
设置好本类的参数
IF this.of_IsRegistryAvailable（） THEN
this.inv_apppref.of_SetAppKey &
(this.of_GetAppKey（）)
this.inv_apppref.of_SetUserKey &
(this.of_GetUserKey（）)
ELSE
this.inv_apppref.of_SetAppINIFile &
(this.of_GetAppINIFile（）)
this.inv_apppref.of_SetUserINIFile &
(this.of_GetUserINIFile（）)
END IF
设置要保存的信息
this.inv_apppref.of_SetRestoreApp(TRUE)
this.inv_apppref.of_SetRestoreUser(TRUE)
然后在适当的时候调用其它函数完成相应的功能。
三.n_cst_debug调试服务类
调试服务类主要应用于对使用PFC编程的应用程序的调试，可在程序中打开和关闭调试窗口，打开调试服务，PFC的有关信息会在调试窗口中显示；也可自已在适当的地方加入调试语名，以在调试窗口中显示所需要了解的信息，来了解程序的运行，帮助查找错误。
继承关系：pfc_n_base : n_base : pfc_n_cst_debug : n_cst_debug
调试服务所提供的函数
of_ClearLog（） 清除所有以前的调试信息
of_GetAlwaysOnTop（） 返回w_debugLog窗口是否总在最前面
of_IsLogOpen（）返回w_debugLog窗口是否打开
of_Message（）发送一条信息到调试服务日志中
of_OpenLog（）打开w_debugLog窗口
of_PrintLog（）打印调试服务日志信息
of_SetAlwaysOnTop（）设置w_DebugLog窗口总在最前面
of_SetDWProperty（）设置是否显示数据窗口的属性窗口
of_SetSQLSpy（）开始或结束SQL的监视
事件
constructor构造事件
destructor析构事件
用法
在pfc_Open（）事件中,调用:gnv_app.of_SetDebug(TRUE) //打开调试服务
在pfc_Open（）事件中,调用:gnv_app.inv_Debug.of_SetSQLSpy(TRUE) //打开SQL监视
在pfc_Open（）事件中,调用:gnv_app.inv_Debug.of_SetDWProperty(TRUE) //打开数据窗口属性窗口
在pfc_Open（）事件中,调用:gnv_app.inv_Debug.of_OpenLog(TRUE) //打开日志窗口
在需要的时候调用gnv_app.inv_Debug.of_Message（）函数来发送信息
说明:pfc_Open（）事件是指n_cst_AppManager类中的pfc_Open（）事件,其实,这些代码也可在其它地方执行,只不过放在这儿比较方便而已。
四.n_tr调试服务类
n_tr是PFC提供的用于数据事务处理的一个用户自定义对象,所有使用PFC的应用中的事务对象应该都使用此对象,它集成了SQL Spy,在应用中可对此应用进行扩展,例如将返回的信自汉化等等。
继承关系:pfc_n_tr : n_tr
函数(具体参数请看帮助):
of_Begin（）一个空的函数,你可以加入一些代码来实现特殊的BEGIN TRANSACTION
of_Commit（）提交事务
of_Connect（）连接数据库
of_CopyTo（）以当前事务对象为样板建立另一个事务对象
of_Disconnect（）断开与数据库的连接
of_DistinctValues（）取得一个列中所有不同的数据放在数组中
of_End（）一个空的函数,帮助实现特殊的END TRANSACTION
of_Execute（）执行一条SQL语句
of_GetAutoRollback（）取得AutoRollback的状态
of_GetName（）取得由SetName设置的名称(事务注册类调用)
of_GetSqlState（）取得由数据库返回的状态字符串
of_GetTrace（）取得跟踪状态
of_Init（）初始化事务对象
of_IsConnected（）测试事务对象是否与数据库连接
of_MessageBox（）显示一条信息
of_Rollback（）回退事务
of_SetAutoRollback（）设置自动回退属性
of_SetName（）设置事务对象的名称
of_SetTrace（）设置跟踪属性
of_SetUser（）设置连接数据库时的用户名及口令
用法：
1.如果事务对象不是SQLCA,则建立:
itr_security = CREATE n_tr
否则将SQLCA的类型设置为n_tr
2.如果用到事务登录服务,则登录所有事务对象:
gnv_app.inv_trregistration.of_Register(SQLCA)
// Assumes an itr_security instance variable
gnv_app.inv_trregistration.of_Register(itr_security)
// Assumes an itr_security instance variable
3.设置好AutoRollback属性:
SQLCA.of_SetAutoRollback(TRUE)
itr_security.of_SetAutoRollback(FALSE)
4.在必要的时候调用相关的函数
说明:事务对象的属性可以一次性从一个INI文件或是注册表主键中读出,请看of_Init（）函数。
全国各地天气预报查询
上海市
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
北京市
吉林省
吉林省
吉林省
吉林省
吉林省
吉林省
吉林省
吉林省
吉林省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
天津市
宁夏回族自治区
宁夏回族自治区
宁夏回族自治区
宁夏回族自治区
宁夏回族自治区
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山西省
山西省
山西省
山西省
山西省
山西省
山西省
山西省
山西省
山西省
山西省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江西省
江西省
江西省
江西省
江西省
江西省
江西省
江西省
江西省
江西省
江西省
河北省
河北省
河北省
河北省
河北省
河北省
河北省
河北省
河北省
河北省
河北省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
海南省
海南省
海南省
海南省
海南省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
福建省
福建省
福建省
福建省
福建省
福建省
福建省
福建省
福建省
西藏自治区
西藏自治区
西藏自治区
西藏自治区
西藏自治区
西藏自治区
西藏自治区
贵州省
贵州省
贵州省
贵州省
贵州省
贵州省
贵州省
贵州省
贵州省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
重庆市
重庆市
陕西省
陕西省
陕西省
陕西省
陕西省
陕西省
陕西省
陕西省
陕西省
陕西省
青海省
青海省
青海省
青海省
青海省
青海省
青海省
青海省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省