第03章 窗口与控件

《PowerBuilder实用教程》叶核亚王青云第03章窗口与控件3.1窗口3.2常用控件3.1窗口3.1.1窗口与控件概述3.1.2窗口画板上的操作3.1.3窗口的属性、事件和函数3.1.4通过消息对象message变量传递参数3.1.1窗口与控件概述在PowerBuilder中，窗口是一种独立的PowerBuilder系统对象。窗口对象具有可视界面，窗口的属性决定了窗口的外在特征。窗口的事件反映了窗口能够响应用户操作的类型。窗口的函数提供了控制窗口的简洁而方便的手段。窗口与用户交互的功能实际上是由窗口上的控件完成的。控件（control）也是系统对象，大多数控件具有可视界面，但它们不是独立的PowerBuilder系统对象，不会出现在系统树窗口中，只能被放置在窗口对象这样的容器中。3.1.2.窗口画板上的操作

1.打开窗口画板2.窗口画板组成3.添加控件4.控件布局5.显示隐藏的控件6.选择窗口或控件的事件编写脚本7.自定义窗口函数1.打开窗口画板新建一个窗口对象时，系统将自动打开窗口画板。操作步骤是，执行File|New菜单，在New对话框的PBObject页上选择Window图标，则新建一个窗口对象。对于已创建的窗口对象，在系统树窗口中，选中窗口对象，执行弹出式菜单Edit，系统将打开窗口画板。

2.窗口画板的组成

窗口画板的布局和属性视图如图3.1所示。

3.添加控件

执行“Insert|Control|控件名称”菜单项，或者在窗口画板工具栏上的控件工具箱中选择一种控件图标，在窗口中单击要放置该控件的地方，即可将控件加入窗口中。控件工具箱中的图标如图所示。鼠标指向控件图标时，会出现相应的控件名称。4.控件布局

(1)使用网格(2)移动控件(3)改变控件的大小(4)控件对齐设置网格的操作是，单击Design|Options菜单项，在Options对话框的General页上，选中ShowGrid属性时显示网格。选中控件，用鼠标拖动控件可以将控件移动到指定位置，也可以用键盘上的移动光标键移动控件。选中控件，用鼠标拖动控件的边框可以改变控件的大小，或者按住【Shift】键的同时，使用移动光标键也可以改变控件大小。窗口上选中多个控件，以选中的第一个控件作为对齐的基准控件，可以进行以下3方面的对齐操作5.显示隐藏的控件对于程序运行时不需要显示的控件，可以在设计窗口时不选中该控件的Visible属性，这样就能使窗口上不显示该控件。执行Design|ShowInvisibles菜单，系统将显示被隐藏的控件。改变控件可视性更好的方法是，通过脚本让程序运行时动态设置Visible属性的值。6.选择窗口或控件的事件编写脚本为窗口或控件的事件编写脚本的方法是：单击窗口空白处或选中控件，执行弹出式菜单Script，打开窗口或控件的脚本视图。确认对象列表框中的对象，在事件列表框中选择需要编写脚本的事件，在脚本编辑区输入脚本程序。7.自定义窗口函数

用户也可以定义窗口函数，操作步骤是：(1)打开窗口画板的脚本视图。(2)在对象列表框中选择Functions，在事件列表框中选择NewFunction，可定义新函数，指定函数名，函数参数及参数类型，函数返回值类型，编写函数体语句。在事件列表框中选择函数名可编辑已定义的函数。(3)用户定义的窗口函数将添加到窗口画板的函数列表视图（FunctionList）中。在函数列表视图中双击指定窗口函数即可打开该函数进行编辑。执行函数列表视图的弹出式菜单Add，也可定义新函数。3.1.3窗口的属性、事件和函数

1.窗口属性2.窗口类型3.窗口事件4.窗口函数1.窗口属性窗口的属性决定了窗口显示的风格。在窗口画板中的属性视图上，可以设置窗口的属性。属性视图包含4个属性页：General、Scroll、Toolbar和Other。General属性页，指定窗口类型、窗口状态、窗口标题、窗口菜单、可视性、有效性和窗口外观等常规属性。Scroll属性页，指定窗口的滚动特性。Toolbar属性页，指定与窗口关联的菜单工具栏属性。Other属性页，指定窗口在屏幕上的初始位置X、Y坐标，窗口宽度和高度。2.窗口类型

(1)主窗口(2)子窗口(3)弹出式窗口(4)响应式窗口(5)MDI窗口(6)带微帮助的MDI窗口3.窗口事件窗口事件见下表：4.窗口函数窗口函数见下表：3.1.4通过消息对象Message变量传递参数使用消息对象Message，既可以在打开窗口时向窗口传递参数，关闭响应式窗口时从窗口返回值；也可以在调用TriggerEvent()或PostEvent()函数触发事件时传递处理事件所需的参数，在事件脚本中返回值。1.向窗口传递参数2.关闭窗口时返回值3.触发事件时传递参数4.在事件中返回值1.向窗口传递参数调用OpenWithParm()函数可以向窗口传递参数，格式为：OpenWithParm(窗口,参数{,父窗口})其中，〈窗口〉是待打开的窗口名。〈参数〉指定要传递给窗口的数据，该数据保存在Message对象的属性中，参数的数据类型必须是下述3种类型之一：String、Numeric、PowerObject。〈父窗口〉指定要打开窗口的父窗口，它是可选项，仅限于子窗口和弹出式窗口。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为null，则函数返回null。2.关闭窗口时返回值调用CloseWithReturn()函数，可以关闭窗口并将返回值保存在Message对象中，该函数仅用于响应式窗口。格式为：CloseWithReturn(窗口,返回值)3.触发事件时传递参数调用对象的TriggerEvent()函数可以触发任何指定对象的事件，并立即执行该事件上的脚本。以下是TriggerEvent()函数带有事件参数的一种重载语法格式：对象.TriggerEvent(事件[,参数1,参数2])其中，〈对象〉指定将触发事件的对象或控件名。〈事件〉指定对象将触发的事件，取值为枚举类型TrigEvent的值。〈参数1〉和〈参数2〉是两个可选参数，类型分别为word和long，它们用于传递事件的参数，当事件发生后其值将保存到Message的WordParm和LongParm属性中。4.在事件中返回值事件也有返回值，在事件脚本返回特定值可以控制事件的执行。事件的返回值将由Message对象的ReturnValue属性传递。3.2常用控件3.2.1文本显示与编辑控件3.2.2按钮3.2.3选项按钮3.2.4列表框3.2.5图形、图像控件和滚动条3.2.6树形视图3.2.1文本显示与编辑控件1.静态文本框2.单行编辑框3.掩码编辑框4.多行编辑框5.多行带格式文本编辑框1.静态文本框静态文本（StaticText）控件仅用于显示文本，不能输入。除了常规属性，静态文本在General页上的主要属性有Name、Text、Border、BorderStyle、Alignment、BorderColor、FillPattern等。2.单行编辑框单行编辑框（SingleLineEdit）控件用于显示和输入一行文本。它是应用程序运行时人机交互的常用控件。除了常规属性，单行编辑框的属性有DisplayOnly、Password、AutoHScroll、TextCase、Limit等。单行编辑框的事件有Modified、GetFocus、LoseFocus等。3.掩码编辑框掩码（Mask）是指带格式的数据。掩码编辑框（EditMask）是一种按照指定格式输入并显示数据的单行编辑框控件。掩码编辑框在Mask属性页上指定数据的格式，可带格式的数据类型有数值型、字符串和日期时间值。3.掩码编辑框设置mask属性如下图所示：4.多行编辑框多行编辑框（MultiLineEdit）控件用于显示和输入多行文本。它的全部文本只有一种字体。除单行编辑框的属性、事件和函数外，多行编辑框增加的属性还有AutoVScroll、HScrollBar、VScrollBar、IgnoreDefaultButton、TabStop等。5.多行带格式文本编辑框多行带格式文本编辑框（RichTextEdit）用于编辑基于WindowsRTF（RichTextFormat）格式的多行文本，RTF格式包含文本的颜色、字体、字号和对齐方式等。RichTextEdit有自己的工具栏和标尺，还能够输入、编辑、格式化以及保存与打印文本。3.2.2按钮按钮是一种常用控件，用于完成一种特定操作。PowerBuilder提供了2种按钮：命令按钮和与图像按钮。1.命令按钮2.图像按钮1.命令按钮命令按钮（CommandButton）是标准的Windows按钮，带有一个指示按钮功能的标签。命令按钮总以三维形象显示，它没有边框属性，不能修改按钮标签的字符颜色和背景颜色。命令按钮的Text属性指定按钮标签，Default属性指定是否为默认按钮，Cancel属性指定是否为取消按钮。命令按钮的主要事件是Clicked事件，当用户单击按钮时触发该事件。2.图像按钮图像按钮（PictureButton）是可以显示BMP、RLE或WMF格式图像的命令按钮，通常带有2种不同图像分别表示按钮有效和无效状态。当PictureButton的Enabled属性为true时，显示PictureName属性指定的图像；当Enabled为false时，显示DisableName属性指定的图像。OriginalSize属性指定按图像按钮本身的大小显示图像，否则按图像大小自动调整图像按钮的尺寸。3.2.3选项按钮在一组状态中进行选择的方式有2种：单项选择和多项选择。1.单选钮2.复选钮3.组框1.单选钮单选钮（RadioButton）用来显示一组互斥的选择。同一组单选钮中，任何时候最多只能有一个被选中。一旦选中一个单选钮，则前一个选中的单选钮会自动变为未选中状态。判断各单选钮是否同组的依据是，它们是否被置于同一个容器中。2.复选钮复选框（CheckBox）是一个带标签的方框，方框中打勾号表示选择，表示不选择。鼠标单击可改变它的状态。复选框选中与否的状态用Checked属性表示。当Checked属性值为true时，复选框为选中状态（），当Checked为false时，是未选中状态（□），默认值是false。复选意味着可以有几个复选框同时被选中，即每一个复选框状态的改变，并不影响其他复选框的状态。3.组框组框（GroupBox）有两个用途：一是装饰界面，二是对单选钮分组。单选钮、复选框的分组通过组框来实现，因此，我们通常看到的界面中，组框与单选钮、复选框常常结伴而行。组框的分组作用只对单选钮有效，对其他控件，组框只起到装饰效果。3.2.4列表框当需要选择的数据项较少时，可以使用前面介绍的复选框和单选钮。如果有很多数据项，可以使用列表框。1.列表框2.图像列表框3.下拉列表框4.下拉图像列表框1.列表框列表框（ListBox）将多个数据项显示在一个矩形框中，既可以进行单项选择，也可以进行多项选择。在列表框中的某一数据项上单击，则选中该数据项，被选中的数据项以高亮度显示。2.图像列表框

图像列表框（PictureListBox）是数据项前带有图标的列表框。其Pictures属性页上的PictureName属性可以指定列表框所带的多个图像。Items属性页上的Item[]属性是一个结构数组，每个数组元素由Text和PictureIndex组成，Text指定列表项的显示文本，PictureIndex指定所需图像在PictureName属性中的序号。3.下拉列表框

下拉列表框（DropDownListBox）是单行编辑框和列表框的结合体，既可在编辑框中输入数据，也可在其下拉列表框中选择数据项。下拉列表框的AllowEdit属性指定是否可编辑，HScrollBar和VScrollBar指定是否在需要时显示水平、垂直滚动条。4.下拉图像列表框与图像列表框类似，下拉图像列表框（DropDownPictureListBox）中的每个数据项前都带有一个图标。3.2.5图形、图像控件和滚动条1.图形控件2.图像控件3.滚动条1.图形控件图形控件（drawingcontrol）用于显示图形。它们没有