第六章 应用对象,6.1 应用对象及其创建,6.2 应用对象的属性,6.3 应用对象的事件,6.4 应用对象的函数,6.1 应用对象及其创建,1、应用对象中包含的内容,应用对象是PowerBuilder应用程序启动时装入的第一个对象，它定义了系统级的属性和行为。它包括以下内容： （1）缺省字体 （2）应用程序图标 （3）缺省的全局变量 （4）可以定义应用对象的结构、函数和实例变量、全局变量、全局外部函数,2、创建应用对象,应用对象的创建方法在第3章中已有较详细的讨论。对于初学者，建议不使用应用模板来创建，因为使用应用模板生成的应用比较复杂，且不易修改，不利于PowerBuilder的入门学习。,3、打开应用对象,创建了应用对象，用户就可以打开它，并对其进行修改。打开应用对象的方法有以下几种： （1）通过菜单打开应用对象。 （2）通过工具条的“Open”图标打开应用对象。 （3）在Library画板（也称为库管理画板）中打开应用对象。 （4）在系统树（System Tree）窗口中双击应用对象的图标。 一般情况下，打开应用对象后，首先进入其编程视图，并且默认情况下，首次进入的是对它的“Open”事件进行编程。,6.2 应用对象的属性,1、在应用画板中设置应用对象的属性,应用对象是开发PowerBuider应用程序必须用到的对象，应用对象的属性对整个应用程序的开发起着举足轻重的作用。利用应用对象可以为应用程序设置下述属性： （1）设置缺省字体 应用对象的四个字体属性决定了开发应用程序过程中经常使用的四种字体，这四个字体属性分别为：Text Font，Column Font，Header Font，Label Font。Text Font决定窗口中的控件、用户对象、数据窗口中静态文本的缺省字体，Column Font指定数据窗口中检索出的数据使用的缺省字体，Header Font定义列表风格（tabular）和网格风格（grid）数据窗口对象中列标题的缺省字体，Label Font确定自由风格（freeform）数据窗口对象中列标签的缺省字体。 在开始开发应用程序时，根据需要先设定这些字体，以后设计其他对象时就免除了反复设置字体的重复劳动。,【注意】,修改应用对象的字体属性后，必须重新启动PowerBuider，新的属性值才起作用。 新修改的应用对象字体属性只对修改后新生成的对象（例如窗口、数据窗口对象等）起作用（是它们的缺省字体），不影响修改应用对象字体属性前已建立对象的字体。,（2）设置应用中应包括的库名 在PowerBuilder中，通过设置应用目标的属性可以设置应用中包括的库名（这些库名就是以PBL为后缀名的文件），放置在前面的应用库将首先被查找（注：一个应用程序既可以存放在一个应用库中，也可以分散存储在多个库中。不要使单个应用库过大，通常不宜超过800K，否则将增加系统的查库时间）。 【 注意】 可在“Libaries Search Path”多行编辑框中直接输入带全路径的库文件名，使用Ctrl+Enter生成新行，直接按Enter键时将关闭属性设置对话框。 在所包含的库中删除某个库时，直接在“Libaries Search Path”编辑框中删除即可。,（3）设置应用程序图标 应用程序图标的用途是代表应用程序。程序运行后，如果用户将其最小化，该图标就出现在屏幕的底端。 （4）指定缺省全局变量的类型 PowerBuider提供了五个内置的全局变量（SQLCA，SQLDA，SQLSA，Error，Message），它们都有缺省的类型，但开发者可对其进行修改。 （5）设置应用对象的一般属性 （6）设置应用对象的工具条属性,2、在代码中设置应用对象的属性,（1）AppName和DisplayName属性 应用对象的AppName属性指明了应用对象的名称，该属性在运行时不能被修改，它是个只读属性。DisplayName属性指定了应用对象的显示名，它能够方便用户的阅读，在运行时可以修改。 （2）DDETimeOut属性 当PowerBuider应用程序作为DDE客户端时，DDETimeOut属性指定了该应用程序等待服务器响应的时间，超过这段时间后，客户程序将放弃数据交换。DDETimeOut属性指定的时间以秒为单位，缺省值为10s。 （3）MicroHelpDefault属性 当应用程序使用多文档界面（MDI）时，使用MicroHelpDefault属性设置状态栏显示的缺省文本（不设置时，缺省为Ready）。 （4）RightToLeft属性 RightToLeft属性用于控制MessageBox()对话框中字符显示的方向，缺省值为False，表示自左向右显示字符（这也是汉语和英语的书写方式）。当把RightToLeft属性设置为True时，自右向左显示字符。该属性主要用于开发多国语言的应用程序，需要注意的是，RightToLeft属性只在希伯来语或阿拉伯语版本的PowerBuider中有效，且需要具备自右向左显示特性的操作系统的支持。,（5）ToolbarFrameTitle属性 ToolbarFrameTitle属性指定应用程序中MDI框架窗口浮动工具条的标题，缺省值为FrameBar。 （6）ToolbarSheetTitle属性 ToolbarSheetTitle属性指定应用程序中工作表浮动工具条的标题，缺省值为SheetBar。 （7）ToolbarPopMenuText属性 ToolbarPopMenuText属性指定工具栏弹出菜单中位置菜单项的显示文本，缺省时的显示如图6-8所示。 （8）ToolbarText和ToolbarTips属性 两个属性的类型都是Boolean，ToolbarText属性决定在工具栏图标上是否显示文字提示，其值为True时显示，为False时不显示。ToolbarTips属性指定当鼠标指针移动到工具栏图标上时是否显示跟踪提示，其值为True时显示，为False时不显示。注意，ToolbarTips属性的设置只在ToolbarText属性设置为False时有效。 （9）ToolbarUserControl属性 如果不想让用户控制工具栏（比如移动工具栏等），可通过将ToolbarUserControl属性设置为False来实现，此时，将关闭工具栏的弹出菜单功能，用户也不能通过拖曳操作移动工具栏的位置。,6.3 应用对象的事件,1、Open（打开）事件,应用对象的Open事件在启动应用程序时发生，且只发生一次。一般来说，在“Open”事件处理程序中应该完成下述工作： （1）完成初始化工作。 （2）利用INI文件或注册表设置某些属性，或初始化一个事务对象。 （3）查询环境，保证应用程序的所有资源都可以使用、连接要访问的数据库。 （4）打开应用程序的第一个窗口。,2、Close（关闭）事件,应用对象的Close事件只发生一次，它发生在退出应用程序、返回到操作系统之前，通常在这个事件的处理程序中完成下述工作： （1）删除应用程序运行过程中创建的对象 （2）往INI文件中保存状态信息，以便下次运行程序时恢复状态。 （3）关闭应用程序中尚未关闭的文件。 （4）断开与数据库的连接。,3、Idle（空闲）事件,“Idle”事件在下述情况下发生：首先在应用程序的某段程序中使用Idle（）函数设置一个定时器时间间隔，如果在时间间隔规定的时间内用户没有敲击键盘或使用鼠标（即用户没有操作应用程序），那么系统产生应用对象的“Idle”事件，用户的任何交互操作都将重设该定时器。“Idle”事件的用途有下述几种： （1）创建自己独具特色的屏幕保护程序。 （2）隐藏机密数据并强制用户在长时间未操作应用程序时重新输入密码。 （3）了解用户是否长时间未操作应用程序，如果是的话，应用程序可以自动退出、返回系统，这样有助于减少数据库的连接数目并节省数据库资源。,4、SystemError（系统出错）事件,“SystemError”事件是处理运行错误的最后一道关卡，用来处理最严重的错误，可以在此处编写错误处理和可能的恢复代码，简单的措施是显示出错信息。如果未对此事件编程，那么系统出错时PowerBuider会通过对话框显示错误代码和错误信息，不过是用英文表达的。,5、ConnectBegin（连接开始）事件,“ConnectBegin”事件用于分布式PowerBuider应用的服务器端。当客户程序试图连接到服务器程序时，触发服务器程序应用对象的“ConnectBegin”事件。,6、ConnectEnd（连接结束）事件,“ConnectEnd”事件用于分布式PowerBuider应用的服务器端。当客户程序试图断开与服务器程序的连接时，触发服务器程序应用对象的“ConnectEnd”事件。,6.4 应用对象的函数,应用对象具有下列函数，如下表所示，读者可以根据需要选用。,