PFC编程基础

小灰灰 2022-06-17 09:50 600阅读 0赞

概要：  
　　这一章阐述了 PFC 编程的基本技巧，同时也告诉了你如何开始运用 PFC 编写应用程序。  
　　设置应用程序管理器  
　　首先建立一个PFC应用程序的第一步就是配置应用程序以及建立应用程序管理器- -n\_cst\_appmanager。应用程序管理器将替代原来的应用程序对象。原来在应用程序对象中编写的脚本将全部改写在应用程序管理器中。应用程序管理器中同时还通过实例变量、函数来维护应用程序的属性。其中有框架窗口、应用程序与用户的INI文件或注册键以及帮助文件等。  
　　注意：  
　　使用分开的物理文件  
　　每个独立的应用程序都必须拥有自己独立的一套文件。你不可以共享父类文件，也就是那些以PFC开头的文件。这是由PFC的内部继承关系而决定的。  
　　例如，假设应用程序1与应用程序2都拥有它们自己的一套扩展的PFC库文件，但是它们共享父类文件（PFC库文件）。这时应用程序1在自己的PFE（PFC扩展库）的w\_master中增加了一个函数名为of\_SetData。这样这个函数将在w\_master的所有子类中都有效，这些子类是pfc\_w\_main，pfc\_w\_frame，pfc\_w\_sheet 等。而这些对象恰恰在这两个应用程序共享的父类文件（PFC库文件）中。这样当应用程序2重新生成应用程序时（regenerate）由于应用程序2的PFE文件中没有of\_SetData函数。这样w\_master的所有子类中的关于of\_SetData函数的指针都将被删除。这样当应用程序1运行时将会导致运行时错误与编译错误。  
　　具体步骤  
　　1. 打开应用程序画笔。  
　　2. 定义库文件列表。  
PFCAPSRV.PBL  
PFCDWSRV.PBL  
PFCMAIN.PBL  
PFCUTIL.PBL  
PFCWNSRV.PBL  
PFEAPSRV.PBL  
PFEDWSRV.PBL  
PFEMAIN.PBL  
PFEUTIL.PBL  
PFEWNSRC.PBL  
PFCOLD.PBL（如果你的应用程序是使用老版本的PFC库那么请增加该文件到库列表 中）   
　　3. 在应用程序画笔中打开脚本画笔，定义n\_cst\_appmanager类型的全局变量gnv \_app。  
　　n\_cst\_appmanger gnv\_app 这个变量名必须是gnv\_app，因为PFC的对象、函数、事件都需要这个n\_cst\_appm anager或它的子类的全局变量—gnv\_app。  
　　4. 增加如下代码到应用程序对象的OPEN事件中。它的用途是创建n\_cst\_appmanager、调用pfc\_Open事件。  
gnv\_app = Create n\_cst\_appmanager  
gnv\_app.Event pfc\_Open(commandline)   
　　5. 增加如下代码到应用程序对象的CLOSE事件中。  
gnv\_app.Event pfc\_Close()  
Destroy gnv\_app   
　　6. 增加如下代码到应用程序对象的SystemError事件中。调用pfc\_SystemError事 件。  
gnv\_app.Event pfc\_SystemError()  
　　7. 关闭应用程序画笔，保存所作的修改。  
　　8. 打开用户自定义对象画笔。在PFEAPSRV.PBL中找到n\_cst\_appmanager并打开，或者是它的子类。  
　　9. 在n\_cst\_appmanager的构造事件（Constructor Event）中调用它的函数来初始化关于软件版本号、公司、和INI文件的实例变量。  
　　10. 在 n\_cst\_appmanager的pfc\_Open事件中打开你所想要的应用程序Service 。  
　　你所想打开的Service 调用函数Application preference of\_SetAppPreference DataWindow caching of\_SetDWCache Error of\_SetError Most recently used object of\_SetMRU Transaction registration of\_SetSecurity Debug of\_SetDebug  
　　11. 在pfc\_Open事件中增加打开你的初始窗口的代码，例如框架窗口（Frame Window）或者调用显示快闪窗口的of\_Splash（）函数。  
　　12. （可选）增加代码到pfc\_PreAbout，pfc\_PreLogonDlg，pfc\_PreSplash事件中，用于定制关于对话框（About box）、登录对话框（Logon box）、快闪窗口（splash screen）。  
　　13. （可选）增加代码到pfc\_idle，pfc\_ConnectionBegin，pfc\_ConnectionEnd事件中。  
　　l\_ 在应用程序对象的idle事件中调用pfc\_idle事件。  
　　l\_ 在应用程序对象的ConnectionBegin事件中调用pfc\_ConnectionBegin事件。  
　　l\_ 在应用程序对象的 ConnectionEnd事件中调用pfc\_ConnectionEnd事件。  
　　14. 保存n\_cst\_appmanager  
　　如何显示快闪窗口  
　　非常简单，只需在pfc\_Open事件中，在打开第一个窗口的代码之前写上如下代码 ：  
　　this.of\_Splash（1）  
　　Open（w\_tut\_frame）（根据不同的应用程序有不同的变化！）  
　　如何显示登录窗口  
　　1. 在框架窗口的Open事件中调用of\_LogonDlg函数：  
Integer li\_return  
li\_return = gnv\_app.of\_LogonDlg( )  
IF li\_return = 1 THEN  
this.SetMicroHelp("Logon successful")  
ELSE  
MessageBox("Logon", "Logon failed")  
Close(this)  
End If   
　　Of\_LogonDlg函数将显示w\_logon对话框，同时还会提示输入用户名、密码，当用 户点击OK按钮时还会触发n\_cst\_appmanager的pfc\_Logon事件。  
　　同样，你也可以在n\_cst\_appmanager的pfc\_Open事件中的打开框架窗口之后立即 调用Of\_LogonDlg函数。但是绝对不要在Of\_Splash之后立即调用Of\_LogonDlg 。  
　　2. 在n\_cst\_appmanager的pfc\_logon事件中编写登录到数据库的代码。这个例子 假设有一个INI文件，它包含了所有的需要登录到数据库的信息，除了用户名、密码以外。同时还假设你已将SQLCA的默认类型改为n\_tr（PFC制定的书屋对象类型 ）。  
Integer li\_returnString ls\_inifile, ls\_userid, ls\_password  
ls\_inifile = gnv\_app.of\_GetAppIniFile()  
IF SQLCA.of\_Init(ls\_inifile,"Database") = -1 THEN  
Return -1  
END IF  
// as\_userid and as\_password are arguments  
// to the pfc\_Logon event  
SQLCA.of\_SetUser(as\_userid, as\_password)  
IF SQLCA.of\_Connect() = -1 THEN  
Return -1  
ELSE  
gnv\_app.of\_SetUserID(as\_userid)  
Return 1  
End If  
建立应用程序  
　　建立一个MDI应用程序  
　　使用w\_frame，w\_sheet窗口作为你的框架窗口与表单窗口的父类。在w\_sheet窗口 中增加你的应用程序中所有表单窗口需要的事件、实例变量、函数。  
　　你必须为每一个表单窗口定义菜单。  
　　具体步骤：  
　　1. 为应用程序在w\_frame窗口中作特定的修改。最好是建立一个w\_frame窗口的子类，然后再修改这子类。  
　　2. （可选）在w\_sheet中增加实例变量、函数、用户自定义事件。  
　　3. 建立继承w\_sheet的表单窗口。  
　　4. 建立一个框架窗口（frame window）用的菜单，通常是选用w\_frame 。  
　　5. 为框架窗口指定相应的框架窗口菜单。  
　　6. 建立表单窗口的菜单  
　　7. 为表单窗口（sheet window）指定相应的表单菜单。  
　　8. 在n\_cst\_appmanager的pfc\_Open事件中加入打开框架窗口的代码。  
　　9. （可选）在必要时候，开启框架窗口Service 。  
　　l\_ 调用w\_frame的of\_SetStatusBar函数开启状态条Service 。  
　　l\_ 调用w\_frame的of\_SetSheetManager函数开启表单管理Service 。  
　　在MDI应用程序中打开表单窗口：  
　　1. 在菜单项的Clicked事件中编写有关打开表单窗口的脚本。你需要将表单窗口的名称以字符串的形式传递给Message.StringParm，然后以pfc\_Open为参数调用of\_SendMessage函数：  
n\_cst\_menu lnv\_menu  
Message.StringParm = "w\_products"  
lnv\_menu.of\_SendMessage(this,”pfc\_Open”)   
　　2. 在w\_frame的pfc\_Open事件中访问Message.StringParm，打开指定的表单窗口。  
String ls\_sheet  
w\_sheet lw\_sheet  
ls\_sheet = Message.StringParm  
OpenSheet（lw\_sheet, ls\_sheet, this, 0, Layered!）   
　　建立一个SDI应用程序  
　　在使用PFC建立SDI应用程序中，你将使用w\_main窗口作为你的所有main类型窗口的父类。为了使得你的事件、函数、实例变量能够在所有的窗口中都有效，只需将它们加到w\_main中。  
　　如果你的窗口需要菜单，那么你必须为每一个窗口定义菜单。  
　　具体步骤  
　　1. 继承w\_main窗口，建立一个main类型窗口，最为主窗口。最好是直接修改w\_main窗口。  
　　2. 建立一个主菜单。  
　　3. 根据需要建立其他的菜单与窗口。  
　　4. 在n\_cst\_appmanager的pfc\_Open事件中编写打开主窗口的脚本。  
　　PFC编程过程中的函数使用方法  
　　几乎所有的PFC函数都是对象级函数。这就意味着你必须定义POWERBUILDER对象后才可以使用函数。经过PB封装后的函数使你很轻易的看到哪个函数属于哪个对象。  
　　PFC使用Set/Get/Is 命名规则来控制实例变量。  
　　l\_ of\_Set函数允许你为实例变量赋值  
　　l\_ of\_Get函数允许你获得一个非布尔类型的变量的值  
　　l\_ of\_Is函数允许你确定一个布尔类型变量的真与假  
　　其他类型实例变量的访问规则  
　　PFC定义变量时同时指定为公共类型（public）,那么你将可以随意直接访问。  
　　另外，有些变量由于只是在内部使用，因此不能通过函数进行访问。  
　　除了Set/Get/Is命名规则以外，PFC在为某一Service定义入口参数时使用Regist er/UnRegister规则。例如，你可以调用u\_calculator对象的of\_Register函数来定义Datawindow的那个列使用下拉日历。  
Object qualificationPFC uses access levels (public, private, protected  
) to control your access to functions designed for 内部自动调用 use.  
When you call these functions from outside the object, use dot notatio  
n to qualify the function name. Qualify the function name with the ref  
erence variable used to create the object (in some cases you qualify t  
he function name with the actual object name).   
调用PFC对象函数  
　　1. 确认对象是已否被创建  
　　PowerBuilder在当窗口打开的时候会建立窗口、菜单和可视的用户对象。你要使用函数of\_Setservicename来建立大部分的不可视的用户对象。例如，下面u \_dw的对象函数创建了排序Service（n\_cst\_dwsrv\_sort user object），并且在u\_dw’s中的实例变量inv\_sort中保留它的引用。通常这些代码都在Datawindow的 构造事件中：  
　　this.of\_SetSort（True）  
　　自动实例化对象  
　　某些PFC对象利用了Powerbuilder提供的自动实例化功能。这些对象没有Set函数 。PowerBuilder会在它们声明的时候自动实例化它们。  
　　2. 在应用程序中调用适当的对象函数  
　　这个例子展示了排序Service将利用DataWindow的列名、排序已显示值、 实现当用户点击后排序。同时可以在菜单栏上显示下拉对话框。  
this.inv\_sort.of\_SetColumnNameSource(this.inv\_sort.HEADER) this.inv\_s  
ort.of\_SetUseDisplay(TRUE) this.inv\_sort.of\_SetColumnHeader(TRUE)  
this.inv\_sort.of\_SetStyle(this.inv\_sort.DRAGDROP)   
　　函数重载PFC使用函数重载提供了一个丰富的、富有弹性的编程接口。它通过两种方法实现函数重载。  
　　l\_ 多种语法 多个函数具有不同的参数类型、不同的参数顺序。这使得PFC的函数可以处理多种数据类型的参数。  
　　l\_ 随意的参数数目 许多函数拥有一个具有相同数据类型、相同顺序、参数数目可以变化的参数。它同时还允许PFC为常用的参数提供默认值。  
　　只用于内部处理所重载的函数  
　　除了公有类型的重载函数以外，PFC通常还有一个保护类型的版本，一般都是用来进行内部调用的。例如，n\_cst\_dwsrv\_report中的of\_Addline函数有4个公有类型的版本、一个保护类型的版本。这个保护类型的版本是供其他4个调用的。虽然有些时候可以调用这些保护类型的版本，但是他们纯粹是为了内部调用而设计的  
。  
　　关于PFC事件的编程  
　　PFC包括了预代码的事件、用于实现PFC Service的用户自定义事件。还有一些空的事件，你可以在其中为你的应用程序加入特定的代码，或者执行一些特定的任务。所有的事件都是公有的，你可以直接访问它们。  
　　“预代码事件”与其他的用户自定义事件  
　　预代码事件指的是那些已经在PFC层对象中编号代码的事件。PFC拥有许多具有一定功能的“预代码事件”。这意味着如果你开启了一个Service ，PFC的对象发现该Service已开启了，那么这些“预代码事件”将会执行其中的代码。  
　　例如：u\_dw的Clicked事件就是一个“预代码事件”，它会自动调用那些开启的Service函数。你可以扩展这些事件，但是不可以覆盖它们。  
　　空的用户自定义事件  
　　PFC定义了许多空的用户自定义事件。你可以在其中为你的应用程序写入特定的代码。许多这种事件都是通过菜单而触发的。另外一些则是应用程序代码触发的。  
　　例如：  
　　在u\_dw中有一个用户自定义事件pfc\_Retrieve ，你可以在其中加入检索数据的代码。  
　　Return this.Retrieve（）  
　　有关更多的关于PFC事件的内容请参考PFC Object Reference  
　　PFC中的事件是如何起作用的  
　　PFC是采用如下的方式调用Services中的事件的  
　　1. 当用户触发某个对象的某个事件时，PFC将会调用相应的Service 的自定义事件，同时传递相应的参数。例如：u\_dw的clicked事件会调用n\_cst\_dwsrv\_sort的pfc\_Clicked事件，同时传递X坐标、Y坐标、DW对象（这些其实也是DW的Clicked 事件的参数）。  
　　2. 这些Services的事件同时还有可能调用其他对象函数。例如，n\_cst\_dwsrv\_sort的pfc\_Clicked事件中还调用了n\_cst\_dwsrv\_sort的函数。  
　　尽管你可以直接调用PFC的对象函数，但是调用相应的事件显得更简单，因为这些事件中已经包括了错误检测代码。  
　　关于事件触发前的一些处理  
　　PFC有一种自定义事件名是Prename 。这意味着这些事件是发生在事件name之前的事件。我们把它叫做pre\_event 。你可以随意在pre\_event中增加代码用于扩充相应的事件处理能力。这些pre\_event有：  
pfc\_PreAbout  
pfc\_PreClose  
pfc\_PreLogonDlg  
pfc\_PreOpen  
pfc\_PrePageSetupDlg  
pfc\_PrePrintDlg  
pfc\_PreRestoreRow  
pfc\_PreSplash  
pfc\_PreToolbar  
pfc\_PreUpdate   
　　通常，这些事件中都有一个已经自动实例化了的用户对象的引用变量。这个对象的属性可以影响这个事件的运行。你可以修改这个用户对象的属性，从而达到改变事件的运行或扩展事件的运行效果。有些时候你还需要修改一些其他的对象。  
　　例如，当你需要控制About对话框中的一个附加控件的显示效果时，你需要：  
　　1. 扩展用户对象n\_cst\_aboutattrib ，在其中增加一个用于在w\_about中代表显示效果的实例变量（一个 user ID）。  
　　2. 在w\_about中增加控件（sle\_userid）  
　　3. 在w\_about的Open事件中编写代码，将user ID的值放入单行编辑框中（sle\_userid）  
sle\_userid.text = inv\_aboutattrib.is\_userid  
　　4. 在n\_cst\_appmanager的pfc\_PreAbout事件中编写初始化代码：  
　　inv\_aboutattrib.is\_userid = this.of\_GetUserID（）  
　　然后当你需要显示w\_about时，调用应用程序管理器的of\_About函数即可。  
　　如何使用属性对象  
　　PFC提供了许多专门的属性用户对象。这些用户对象有如下特征：  
　　l\_ 包含公有性质的实例变量  
　　l\_ 自动实例化  
　　l\_ 名称以attrib结尾  
　　l\_ 通常用于向PFC的pre\_event传递信息，例如pfc\_PreAbout  
　　l\_ 可扩展，你可以在其中自己定义其他的实例变量。  
　　因为，你有可能会扩展这些对象。因此，PFC使用对象而不使用对象。  
　　同样你还可以定义对象函数，做到更随意的控制这些对象。  
　　这些属性对象有：  
　　属性对象有关的用法  
n\_cst\_aboutattrib Pfc\_Pre\_About（n\_cst\_appmanager） 调用n\_cst\_appmanager的of\_About函数打开about对话框  
n\_cst\_calculatorattrib Constructor（u\_calculator） 内部自动调用n\_cst\_dirattrib File service object 内部自动调用  
N\_cst\_dwobjectattrib Of\_Describe（n\_cst\_dssrv与n\_cst\_dwsrv） 函数Of\_De scribe返回DataWindow中的对象属性。  
n\_cst\_dwproperyattrib DataWindow Properties objects 内部自动调用 n\_cst\_errorattrib Error message service 用于传递显示内容到w\_message窗口  
n\_cst\_filterattrib DataWindow filter service 用于传递信息到filter对话框  
n\_cst\_findattrib DataWindow find service 传递信息到Find对话框  
n\_cst\_itemattrib PFC ListBox, PictureListBox, and TreeView 内部自动调用  
n\_cst\_linkageattr b DataWindow linkage service 内部自动调用  
n\_cst\_logonattrib Pfc\_PreLogonDlg (n\_cst\_appman ger) 调用n\_cst\_appmanager的of\_LogonDlg函数打开w\_logon窗口  
n\_cst\_mruattrib MRU service 用于窗体的pfc\_MRUProcess和pfc\_PreMRUSave事 件  
n\_cst\_restoreroattrib DataWindow row manager service 内部自动调用  
n\_cst\_returnattrib DataWindow filter and sort services 内部自动调用  
n\_cst\_selectionattrib Selection service Populated with arguments to th  
e n\_cst\_selection of\_Open function  
n\_cst\_sortattrib DataWindow sort service 用于传递信息到Sort对话框  
n\_cst\_splashattrib Pfc\_PreSplash event (n\_cst\_appman ger) 调用n\_cst\_ap pmanager的of\_Splash函数打开w\_splash 。  
n\_cst\_sqlattrib SQL service 该属性对象中含有SQL语句的部分内容。  
n\_cst\_textstyleattrib PFC RichTextEdit control 用于设置和获取text属性（黑体、斜体等）。  
n\_cst\_toolbarattrib Pfc\_PreToolbars event (w\_frame) 调用w\_frame的pfc\_Toolbars事件打开w\_toolbars 。  
n\_cst\_zoomattrib DataWindow print preview service 内部自动调用   
　　PFC的常量  
　　许多PFC对象都包含了常量。使用常量使得程序更加易读。例如：下面两段代码同样是设置Datawindow的linkage风格，但是第二段则显得更加容易理解：  
// 1 = Filter linkage style.  
dw\_emp.inv\_linkage.of\_SetStyle(1)  
// FILTER 作为一个常量  
dw\_emp.inv\_linkage.of\_SetStyle (dw\_emp.inv\_linkage.FILTER)   
　　约定：PFC的所有常量都采用大写。  
　　消息路由  
　　消息路由器可以用于任何一个对象与窗体之间的通讯。不过，大部分时候都是用于菜单与窗体之间的消息传递。它提供了一种查找算法用于确定哪个对象来接收消息。  
　　使用消息路由时：  
　　l\_ 你菜单中的代码只需要知道代用哪个事件，你无须知道当前的窗口时哪个，或者与其相关的对象名称。  
　　l\_ 你的窗口无须维护用户事件，只需简单调用DataWindow的事件即可。从而减少了窗口需要维护的事件数量。  
　　Message = user event  
　　经过消息路由传递的消息实际上就是用户事件名。窗口、控件收到这些消息后就会调用相应的事件。  
　　内置的debug消息  
　　消息路由机制还提供了内置的debug  
　　函数of\_SendMessage的工作流程  
　　当用户选择菜单项时，Clicked事件中的代码便以欲触发的用户事件名为参数（字符串的形式）调用of\_SendMessage函数。Of\_SendMessage调用n\_cst\_menu的of\_SendMessage函数，n\_cst\_menu的of\_SendMessage将会调用窗体的pfc\_MessageRou ter事件，pfc\_MessageRouter事件将会调用你所要触发的用户事件（即在Clicke d中传递字符串参数）。  
　　在MDI与SDI应用程序中，函数Of\_SendMessage调用pfc\_MessageRouter时将有所不同。  
　　消息路由是菜单与窗口之间的通讯桥梁。你不可以通过按钮来触发pfc\_MessageRouter事件。因为，消息路由会调用GetFocus函数判断当前控件。这样当你按下按钮时，按钮便成了当前控件。  
　　PFC中的事务对象  
　　PowerBuilder的强大功能之一就是可以快速便利的访问多种数据库。PowerBuild er使用事务对象（Transaction Object）作为PowerBuilder与Database之间的桥梁。SQLCA就是一个默认的事务对象。  
　　用户自定义对象n\_tr  
　　PFC中有一个n\_tr对象。它是标准事务对象的子类。其中设有实例变量、用户自定义事件、函数，主要用于扩充与数据库的通讯能。  
　　N\_tr提供了一套标准函数用于连接、切断、提交、回滚等数据库操作。使用这些函数代替原有的数据库语句。例如使用of\_Connect代替CONNECT语句。  
　　两处地方使用n\_tr  
　　l\_ 替代sqlca：在应用程序的属性对话框中将SQLCA的默认数据类型设为n\_tr 。  
　　l\_ 附加的事务对象：当你需要访问多个数据库时，你可以再定义一个事务对象。  
　　如果你使用了多个事务对象，你可以使用事务对象的registration service ，做到一次提交全部已打开的事务对象，一次回滚所有已打开的事务对象。  
　　将SQLCA设置为n\_tr类型  
　　1. 打开应用程序画笔  
　　2. 显示属性窗口，选中Variable页  
　　3. 在SQLCA框中输入n\_tr  
　　4. 点击OK  
　　使用n\_tr  
　　1. 如果你不使用SQLCA ，而是使用其他的事务对象。  
　　下面的例子假设itr\_security是n\_tr的实例变量  
　　itr\_security = CREATE n\_tr  
　　2. 初始化实例变量ib\_autorollback 。这个变量的作用是当事务对象正处于连接状态时应用程序被关闭了或者是该事务对象被删除了的时候，该事务对象应该如何操作  
　　itr\_security.of\_SetAutoRollback（FALSE）  
　　关于初始化ib\_autorollback的扩展你可以在n\_tr的构造事件中初始化ib\_autorollback 。  
　　3. 使用n\_tr的of\_Init函数初始化事务对象的属性  
Integer li\_return  
String ls\_inifile  
ls\_inifile = gnv\_app.of\_GetAppIniFile()  
IF SQLCA.of\_Init(ls\_inifile,"Database") = -1 THEN  
MessageBox("Database","Error initializing from " + ls\_inifile)  
HALT CLOSE  
End if   
　　4. 调用of\_Connect进行数据库连接  
IF SQLCA.of\_Connect() = -1 THEN  
MessageBox("Database","Unable to connect using " + ls\_inifile)  
HALT CLOSE  
ELSE  
gnv\_app.of\_GetFrame().SetMicroHelp("Connection complete")  
End if   
　　5. 调用n\_tr的成员函数  
　　调用父类的函数、事件  
　　在扩充父类的函数和事件时，你有可能需要先调用父类的函数或事件，然后再依据返回值进行下面的处理。这对那些具有返回值前缀是PFC的事件特别有意义。你在执行子类的代码前必须先确认父类的代码是否执行成功。  
　　覆盖父类的函数  
　　为了扩展父类的代码，获取父类的返回值。你必须覆盖父类的代码，然后显示的调用父类的函数或事件。  
　　采用如下的语法格式调用父类的事件，同时传递参数、获取返回值：  
　　Result = Super :: Event eventname（arguments  
　　采用如下的语法格式调用父类的函数，同时传递参数、获取返回值：  
　　result = Super :: Function functionname（arguments  
　　下面的例子则覆盖了u\_dw的pfc\_Update事件。当父类的事件处理成功时，子类将信息纪录到日志中。  
Integer li\_return  
// Call ancestor event, passing  
// descendant's arguments.  
li\_return = Super::Event pfc\_Update(ab\_accepttext, ab\_resetflag)  
IF li\_return = 1 THEN  
// ue\_WriteLog is a user-defined event.  
li\_return = this.Event ue\_WriteLog  
END IF  
Return li\_return  
　　在应用程序中增加联机帮助  
　　联机帮助是应用程序中非常重要的一部分。PFC提供了许多函数、事件使得你可以方便的将联机帮助添加到你的应用程序中。  
　　相关信息：有关PFC的帮助对话框请参考“Deploying PFC dialog box HELP” 。  
　　1. 使用n\_cst\_appmanager的of\_SetHelpFile函数设置帮助文件。通常在构造事件中：  
　　this.of\_SetHelpFile（“c:\\eis\\eisapp.hlp”）  
　　2. pfc\_PreOpen是为窗口设置帮助主题的最好的地方  
Long ll\_helpid  
Ll\_helpid = 1020 //1020是一个帮助主题的ID  
Ia\_helptypeid = ll\_helpid   
　　采用这种方式你可以为用户选中的窗口提供详细的帮助。你可以将ia\_helptypeid设置成长整形（此时PFC把它解释成帮助主题的ID），或者是字符串（此时PFC将它解释成关键字）。  
　　3.（可选）如果你没有使用PFC的m\_master的子类。那么，在你的HELP菜单项中调用窗体的pfc\_Help事件。因为，pfc\_Help定义在窗口w\_master中，所以所有的PFC窗口都具有事件。  
　　4. 对于对话框，则在其中的HELP按钮的Clicked事件中编写：  
　　Parent.Event pfc\_Help（）  
　　PFC自动处理窗口级别的帮助  
　　当你从m\_master的子类的菜单中选择Help->Help时，消息路由机制会自动的调用当前活动的窗口的pfc\_help事件。  
　　PFC的升级  
　　PFC在发布PowerBuilder的升级版本时同时也包括了PFC的升级文件。如何升级PFC，请按如下规则：  
　　l\_ PFC的各层（PFC层、PFE层、中间层等）没有任何被修改时：你可以直接安装新的PBLs覆盖原有的PBLs。  
　　注意：每次升级PFC时都保留一份原有的文件备份  
　　l\_ 如果你修改了PFC中的某一层：你必须保证你所作的修改不会被覆盖！请按如下的步骤进行：  
　　将PFC升级到最新版本  
　　1. 将所有扩展层的PBL文件移到一个不会被安装过程覆盖的目录中。  
　　说明：你不应该对PFC的最基类（以PFC为前缀的对象）作任何修改，这里假设你没有对PFC的最基类作任何修改  
　　2. 确定你当前的PFC的版本号。你可以在Readme.txt文件中查看，或者在pfc\_n\_cst\_debug的实例变量中查看。版本号的格式：主版本号.次版本号.修正号  
　　3. 执行安装程序，将PFC安装口的PBL文件放到PFC所在的目录中，覆盖原有的PFC最基类的PBLS ，即以PFC开头的库文件。  
　　4. 合并已存在的扩展对象与新安装的扩展对象。首先详细阅读Readme.txt中说明的新扩展对象清单。然后按照一下的两种方法合并对象：  
　　l\_ 将新的对象COPY到你的扩展PBLS中。  
　　l\_ 将已经存在的对象COPY到新的扩展PBLS中。  
　　5. 启动PowerBuilder  
　　6. （可选）必要的时候调整一下应用程序的库列表  
　　7. 打开库画笔，从新编译一边所有的对象。