数据窗口控件的属性

1、数据窗口的属性属性数据类型意义BorderBoolean指定数据窗口控件是否带有边框。有效取值为：True- 右边框；false-无边框BorderStyleBorderStyle （枚举）指定数据窗口控件的边框风格，有效取值为：StyleBox! 、 StyleLowered ！ 、 StyleRaised ！、 StyleShadowBox！BringToTopBoolean指定PowerBuilder是否把数据窗口控件移动到其它控 件的前面。有效取值为：True-移动，false-不移动ControlMenuBoolean指定数据窗口控件的标题条是否显示控制菜单（在 windows 95

2、系统中控制菜单出现在标题条的左边，由 一个小图标）。有效取值为：True-数据窗口控件标题条 上显示控制菜单；false-数据窗口控件标题条上不显示 控制菜单DataObjectString指定与数据窗口控件相关联的数据窗口对象名或报表 对象名。比如代码中使用语句DragAutoBoolean指定PowerBuilder是否自动把数据窗口控件置入拖拽 模式（Drag Mode）。有效取值为：False-当数据窗口控 件被单击时，数据窗口控件不自动进入拖拽模式。此 时，如果需要让数据窗口控件进入拖拽模式，需要在 代码中使用Drag（）函数手工设置DragIconString指定拖拽图标的名称，该

3、名称可以是系统预定义图标 名（比如 exclamation！ information！等），也可以是 图标文件名（.ICO）缺省时系统使用控件大小的方框作 为拖拽图标。用户拖动控件过程中，当被拖动控件进 入该控件可以被放下的区域时，系统显示拖动图标EnabledBoolean指定该控件是否能用（即用户是否能操作），有效取值 为：True-用户能够操作该控件；False-用户不能够操作 该控件HeightInteger指定该控件的高度（以PBU为单位）HScrollBarBoolean指定当数据窗口控件中不能一次显示全部数据时是否 显示水平滚动条。有效取值为：True-显示水平滚动条； Fals

4、e-不显示水平滚动条HSplitScrollBoolean指定是否在数据窗口控件中显示水平分隔条。显示水 平分隔条是数据窗口控件被划分成左右两个区域中用 户通过拖拽水平分隔条可以改变两个区域的大小，在 两个区域中用户可以查看同一个数据窗口不同部分的 数据。有效取值为:True-显示水平分隔条；False-不显 示水平分隔条IconString指定数据窗口控件使用的图标名称。当数据窗口控件 被最小化时，使用该图标代表数据窗口控件。图标名 称可以是系统预定义图标名（比如 exclamation ！ information！等），也可以是图标文件名（.ICO）LiveScrollBoolean指定数

5、据窗口控件中的数据是否随用户拖拽滚动条而 滚动。有效取值为True-在用户拖拽数据窗口控件上的 滚动条过程中，数据随之滚动；False-在用户拖拽数据 窗口控件上的滚动条的过程中，数据不随之滚动，当 用户停止拖拽滚动条时（放开鼠标左键时），数据滚动 到滚动条指示的位置MaxBoxBoolean指示数据窗口控件的标题条上是否显示最大化按钮。有效取值为：True-显示最大化按钮；False-不显示最大 化按钮MinBoxBoolean指示数据窗口控件的标题条上是否显示最小化按钮。有效取值为：True-显示最小化按钮；False-不显示最小 化按钮ObjectDWObject用于在代码中直接操作数据

6、窗口对象中的对象，包括 设置对象的属性、得到数据窗口中的数据等。数据窗 口对象中的对象包括：列对象、文本对象、图像对象、 按钮对象、Datawindow对象等。利用Object属性操作 数据窗口对象的属性与数据窗口中数据的方法请参阅 第六章“数据窗口对象属性的访问方法”ResizableBoolean指定用户是否能够改变数据窗口控件的大小。有效取 值为:True-用户能够通过拖拽操作改变数据窗口控件 的大小；False-用户不能够改变数据窗口控件的大小RightToLeftBoolean指定数据窗口控件中显示的文本是否米用自右向左方 式。要使该属性起作用，即需要操作系统支持自右向 左显示方式，

7、而且应用程序有Hebrew或Arabic版本的 powerbuilder动态库支持。有效取值为True-文字米用 自右向左显示方式；False-文字米用自左向右显示方式TabOrderInteger指定该控件在窗口中的跳转次序（即按Tab键移动焦 点的顺序）值（0表示用户不能通过按Tab键把输入焦 点移动到该控件上（但依然可以使用鼠标进行操作）TagString指定显示在数据窗口控件标题条上的文字TitleString指定在数据窗口控件上是否显示标题条。当数据窗口 控件显示标题条时，用户能够通过拖拽标题条来改变 数据窗口控件的显示位置。有效取值为：True-在数据 窗口控件上显示标题条；Fal

8、se-在数据窗口控件上不显 示标题条VisibleBoolean指定数据窗口控件是否可见（即是否显示在窗口上）， 有效取值为：True-该控件可见；False-该控件不可见VScrollBarBoolean指定当数据窗口控件中不能一次显示全部数据时是否 显示垂直滚动条。有效取值为：True-显示垂直滚动条； False-不显示垂直滚动条WidthInteger指定数据窗口控件的宽度（以PBU为单位）XInteger指定数据窗口控件在窗口上的X位置（即离窗口左边 缘的距离），以PBU为单位YInteger指定数据窗口控件在窗口上的Y位置（即离窗口顶部的距离），以PBU为单位5.2数据窗口控件的事

9、件事件触发时机ButtonClicking当数据窗口对象上按钮对象的SuppressEventProcessing属性设置为no 后，用户单击该按钮时触发（该事件在ButtonClicked事件之前、Clicked 事件之后触发）。该事件在系统处理按钮的缺省动作前触发。该事件返 回值的意义为：0-继续处理；1不执行按钮的指定动作，但仍会触发 ButtonClicked 事件ButtonClicked当数据窗口对象上按钮对象的SuppressEventProcessing属性设置为no 后，用户单击该按钮时触发。该事件在系统处理完按钮的缺省动作后触 发Clicked当用户单击数据窗口控件中非编辑

10、域或其它位置时触发。该事件返回值 的意义为：1（缺省返回值）继续处理；0-停止处理，不改变输入焦点。Constructor在窗口的Open事件发生之前触发DBError在数据窗口控件访问数据库过程中发生数据库错误时触发。该事件返回 值的意义为：0-缺省值，系统显示出错信息；1-系统不显示出错信息Destructor在窗口的Close事件发生之后触发DoubleClicked当用户双击数据窗口控件中非编辑域或其它位置时触发。在触发双击事 件前，首先触发Clicked单击事件DragDrop当某个被拖拽控件放置到数据窗口控件上时触发DragEnter当某个被拖拽控件进入数据窗口控件时触发DragL

11、eave当某个被拖拽控件离开数据窗口控件时触发DragWithin当某个被拖拽控件处于数据窗口控件内部时触发EditChanged当用户在数据窗口控件的编辑控件中按任何按键时触发Error当数据窗口对象的数据或属性表达式发生错误时触发GetFocus当数据窗口控件得到输入焦点前触发（这个事件发生在该控件被选择并 变为活动控件之前）ItemChanged当数据窗口控件中某个域被修改并且该域失去输入焦点（比如，用户按 下了 Enter键、Tab键或箭头键，或用户单击了数据窗口中其它域）时 触发。该事件返回值的意义为：0-（缺省返回值）接收新修改的值；1- 不接收新修改的值且不允许改变输入焦点；2-

12、不接收新修改的值但允许 改变输入焦点ItemError当用户修改了字段、然后移走焦点、但数据未能通过该列的有效性检查 时触发。该事件返回值的意义为：0-（缺省值），拒绝输入值并显示有效性检查出错信息，同时不允许移走焦点拒绝输入值，但不显示错误信息，同时不允许移走焦点接收输入值拒绝输入值，但允许移走焦点ItemFocusChanged当焦点从一个可编辑字段切换到另一个可编辑字段时触发LoseFocus当数据窗口控件本身失去焦点时触发Other当发生了某个Windows消息、而该消息又不对应于控件的某个PowerBuilder事件时触发PrintEnd数据窗口打印结束后触发PrintPage在每页

13、数据格式化打印之前触发。该事件返回值的意义为：0-打印当前 页；1-跳过当前页PrintStart在开始打印数据窗口之前发生RbuttonDown当右击该控件是触发。对RichText风格的数据窗口来说，如果在定义数 据窗口对象时选中了 “PopUp Menu”复选框，那么右击该控件时不触 犯RButtonDown事件，此时显示弹出菜单Resize当用户或程序改变数据窗口控件的大小时触发RetrieveEnd当数据窗口检索完数据后触发RetrieveRow数据窗口检索一条记录时触发。该事件返回值的意义为：0-（缺省值） 继续随后的检索；1终止检索过程RetrieveStart数据窗口开始检索数

14、据时触发。该事件返回值的意义为：0-（缺省值） 继续检索；1-终止检索；2-从数据库中检索数据前不清除原有数据及缓 冲区RowFocusChanged当数据窗口控件的当前行被改变时触发ScrollHorizontal当用户使用Tab键、箭头键、或滚动条左右移动数据窗口控件中的数据 时触发ScrollVertical当用户使用Tab键、箭头键、或滚动条上下移动数据窗口控件中的数据 时触发SQLPreview在调用 Retrieve（），Update（）或 ReselectRow（）函数后、SQL 语句 被发送到DBMS前发生。由Update（）函数触发该事件时，该事件返回 值的意义为：0-继续更

15、新；1-停止更新；2-跳过本次请求继续进行UpdateEnd当数据窗口更新了数据库后触发UpdateStart调用Update（）函数后、修改数据库数据前触发。该事件返回值的意义 为：0-（缺省值）继续更新；1-不执行更新5.3数据窗口控件的函数函数返回值功能AcceptTextInteger将数据窗口控件中“漂浮”在当前行/列上的编辑框的内 容放入数据窗口缓冲区的当前项中（编辑框的内容必须 通过数据有效性规则检查）CanUndoBoolean检测最近一次编辑操作能否被撤消。返回值为True时能 够撤消，为False时不能撤消CategoryCountInteger返回数据窗口控件指定统计图的

16、数据类别数CategoryNameString返回数据窗口控件指定统计图的数据类别名称ClassNameString返回数据窗口控件的名称ClearInteger删除数据窗口控件的编辑框中所选内容，对RichText风 格数据窗口来说，删除数据窗口中所选内容ClearValuesInteger删除数据窗口控制指定列的代码表中的所有值，该函数 不影响指定列的数据值ClipBoardInteger将数据窗口控件指定列的统计图复制到系统剪贴板CopyInteger将数据窗口控件当前行列上编辑框中的所选内容复制到 系统剪贴板。对RichText风格的数据窗口来说，把数据 窗口控件中所选内容到系统剪贴板

17、CopyRTFString将数据窗口控件中所选的文本、图像、输入字段作为一 个文本格式的字符串返回，位图和输入字段包括在字符 串中CreateInteger使用指定的源代码创建数据窗口对象，并用新的数据窗 口对象取代数据窗口控件中原有的数据窗口对象CrosstabDialogInteger显示“Crosstab Definition”对话框，这样用户能够在运仃 时修改Crosstab风格的数据窗口对象的定义CutInteger将数据窗口控件当前行列上编辑框中的所选内容剪切掉 并保存到系统剪贴板上。对RichText风格的数据窗口来 说，把数据窗口控件中所选内容剪切到系统剪切板DataCount

18、Long返回值数据窗口控件指定图形、指定序列的数据点数DBCancelInteger取消数据库数据检索进程DBErrorCodeLong得到数据库访问出错时的错误编号(即将废弃)DBErrorMessageString得到数据库访问出错时的错误信息(即将废弃)DeletedCountLong返回数据窗口控件中已经被删除但尚未做数据库更新的 行的数量DeleteRowInteger删除数据窗口控件中指定的行DescribeString返回数据窗口控件的指定信息DragInteger开始或结束数据窗口控件的拖动FilterInteger在数据窗口控件中显示满足当前过滤条件的行FilteredCountInteger返回过滤缓冲区中数据行数FindLong语法1：在数据窗口控件中查找满足条件的下一行。语法 2：对RichText风格的数据窗口来说，在该控件中查找满 足条件的文本，如果找到的话，就将其加亮。可以指定 查找方向以及指定是否需要大小写匹配FindGroupChangeL