数据窗口控件的属性.docx

数据窗口的属性 属性 数据类型 意义BorderBoolean指定数据窗口控件是否带有边框。有效取值为：True-右边框；false-无边框BorderStyleBorderStyle（枚举）指定数据窗口控件的边框风格，有效取值为：StyleBox!、StyleLowered！、StyleRaised！、StyleShadowBox！BringToTopBoolean指定PowerBuilder是否把数据窗口控件移动到其它控件的前面。有效取值为：True-移动，false-不移动ControlMenuBoolean指定数据窗口控件的标题条是否显示控制菜单（在windows 95系统中控制菜单出现在标题条的左边，由一个小图标）。有效取值为：True-数据窗口控件标题条上显示控制菜单；false-数据窗口控件标题条上不显示控制菜单DataObjectString指定与数据窗口控件相关联的数据窗口对象名或报表对象名。比如代码中使用语句DragAutoBoolean指定PowerBuilder是否自动把数据窗口控件置入拖拽模式（Drag Mode）。有效取值为：False-当数据窗口控件被单击时，数据窗口控件不自动进入拖拽模式。此时，如果需要让数据窗口控件进入拖拽模式，需要在代码中使用Drag()函数手工设置DragIconString指定拖拽图标的名称，该名称可以是系统预定义图标名（比如exclamation！、information！等），也可以是图标文件名（.ICO）缺省时系统使用控件大小的方框作为拖拽图标。用户拖动控件过程中，当被拖动控件进入该控件可以被放下的区域时，系统显示拖动图标EnabledBoolean指定该控件是否能用（即用户是否能操作），有效取值为：True-用户能够操作该控件；False-用户不能够操作该控件HeightInteger指定该控件的高度（以PBU为单位）HScrollBarBoolean指定当数据窗口控件中不能一次显示全部数据时是否显示水平滚动条。有效取值为：True-显示水平滚动条；False-不显示水平滚动条HSplitScrollBoolean指定是否在数据窗口控件中显示水平分隔条。显示水平分隔条是数据窗口控件被划分成左右两个区域中用户通过拖拽水平分隔条可以改变两个区域的大小，在两个区域中用户可以查看同一个数据窗口不同部分的数据。有效取值为：True-显示水平分隔条；False-不显示水平分隔条IconString指定数据窗口控件使用的图标名称。当数据窗口控件被最小化时，使用该图标代表数据窗口控件。图标名称可以是系统预定义图标名（比如exclamation！、information！等），也可以是图标文件名（.ICO）LiveScrollBoolean指定数据窗口控件中的数据是否随用户拖拽滚动条而滚动。有效取值为True-在用户拖拽数据窗口控件上的滚动条过程中，数据随之滚动；False-在用户拖拽数据窗口控件上的滚动条的过程中，数据不随之滚动，当用户停止拖拽滚动条时（放开鼠标左键时），数据滚动到滚动条指示的位置MaxBoxBoolean指示数据窗口控件的标题条上是否显示最大化按钮。有效取值为：True-显示最大化按钮；False-不显示最大化按钮MinBoxBoolean指示数据窗口控件的标题条上是否显示最小化按钮。有效取值为：True-显示最小化按钮；False-不显示最小化按钮ObjectDWObject用于在代码中直接操作数据窗口对象中的对象，包括设置对象的属性、得到数据窗口中的数据等。数据窗口对象中的对象包括：列对象、文本对象、图像对象、按钮对象、Datawindow对象等。利用Object属性操作数据窗口对象的属性与数据窗口中数据的方法请参阅第六章“数据窗口对象属性的访问方法”ResizableBoolean指定用户是否能够改变数据窗口控件的大小。有效取值为:True-用户能够通过拖拽操作改变数据窗口控件的大小；False-用户不能够改变数据窗口控件的大小RightToLeftBoolean指定数据窗口控件中显示的文本是否采用自右向左方式。要使该属性起作用，即需要操作系统支持自右向左显示方式，而且应用程序有Hebrew或Arabic版本的powerbuilder动态库支持。有效取值为True-文字采用自右向左显示方式；False-文字采用自左向右显示方式TabOrderInteger指定该控件在窗口中的跳转次序（即按Tab键移动焦点的顺序）值（0表示用户不能通过按Tab键把输入焦点移动到该控件上（但依然可以使用鼠标进行操作）TagString指定显示在数据窗口控件标题条上的文字TitleString指定在数据窗口控件上是否显示标题条。当数据窗口控件显示标题条时，用户能够通过拖拽标题条来改变数据窗口控件的显示位置。有效取值为：True-在数据窗口控件上显示标题条；False-在数据窗口控件上不显示标题条VisibleBoolean指定数据窗口控件是否可见（即是否显示在窗口上），有效取值为：True-该控件可见；False-该控件不可见VScrollBarBoolean指定当数据窗口控件中不能一次显示全部数据时是否显示垂直滚动条。有效取值为：True-显示垂直滚动条；False-不显示垂直滚动条WidthInteger指定数据窗口控件的宽度（以PBU为单位）XInteger指定数据窗口控件在窗口上的X位置（即离窗口左边缘的距离），以PBU为单位YInteger指定数据窗口控件在窗口上的Y位置（即离窗口顶部的距离），以PBU为单位 5.2数据窗口控件的事件事件触发时机ButtonClicking当数据窗口对象上按钮对象的SuppressEventProcessing属性设置为no后，用户单击该按钮时触发（该事件在ButtonClicked事件之前、Clicked事件之后触发）。该事件在系统处理按钮的缺省动作前触发。该事件返回值的意义为：0-继续处理；1不执行按钮的指定动作，但仍会触发ButtonClicked事件ButtonClicked当数据窗口对象上按钮对象的SuppressEventProcessing属性设置为no后，用户单击该按钮时触发。该事件在系统处理完按钮的缺省动作后触发Clicked当用户单击数据窗口控件中非编辑域或其它位置时触发。该事件返回值的意义为：1（缺省返回值）继续处理；0-停止处理，不改变输入焦点。Constructor在窗口的Open事件发生之前触发DBError在数据窗口控件访问数据库过程中发生数据库错误时触发。该事件返回值的意义为：0-缺省值，系统显示出错信息；1-系统不显示出错信息Destructor在窗口的Close事件发生之后触发DoubleClicked当用户双击数据窗口控件中非编辑域或其它位置时触发。在触发双击事件前，首先触发Clicked单击事件DragDrop当某个被拖拽控件放置到数据窗口控件上时触发DragEnter当某个被拖拽控件进入数据窗口控件时触发DragLeave当某个被拖拽控件离开数据窗口控件时触发DragWithin当某个被拖拽控件处于数据窗口控件内部时触发EditChanged当用户在数据窗口控件的编辑控件中按任何按键时触发Error当数据窗口对象的数据或属性表达式发生错误时触发GetFocus当数据窗口控件得到输入焦点前触发（这个事件发生在该控件被选择并变为活动控件之前）ItemChanged当数据窗口控件中某个域被修改并且该域失去输入焦点（比如，用户按下了Enter键、Tab键或箭头键，或用户单击了数据窗口中其它域）时触发。该事件返回值的意义为：0-（缺省返回值）接收新修改的值；1-不接收新修改的值且不允许改变输入焦点；2-不接收新修改的值但允许改变输入焦点ItemError当用户修改了字段、然后移走焦点、但数据未能通过该列的有效性检查时触发。该事件返回值的意义为：0-（缺省值），拒绝输入值并显示有效性检查出错信息，同时不允许移走焦点1 拒绝输入值，但不显示错误信息，同时不允许移走焦点2 接收输入值3 拒绝输入值，但允许移走焦点ItemFocusChanged当焦点从一个可编辑字段切换到另一个可编辑字段时触发LoseFocus当数据窗口控件本身失去焦点时触发Other当发生了某个Windows消息、而该消息又不对应于控件的某个PowerBuilder事件时触发PrintEnd数据窗口打印结束后触发PrintPage在每页数据格式化打印之前触发。该事件返回值的意义为：0-打印当前页；1-跳过当前页PrintStart在开始打印数据窗口之前发生RbuttonDown当右击该控件是触发。对RichText风格的数据窗口来说，如果在定义数据窗口对象时选中了“PopUp Menu”复选框，那么右击该控件时不触犯RButtonDown事件，此时显示弹出菜单Resize当用户或程序改变数据窗口控件的大小时触发RetrieveEnd当数据窗口检索完数据后触发RetrieveRow数据窗口检索一条记录时触发。该事件返回值的意义为：0-（缺省值）继续随后的检索；1终止检索过程RetrieveStart数据窗口开始检索数据时触发。该事件返回值的意义为：0-（缺省值）继续检索；1-终止检索；2-从数据库中检索数据前不清除原有数据及缓冲区RowFocusChanged当数据窗口控件的当前行被改变时触发ScrollHorizontal当用户使用Tab键、箭头键、或滚动条左右移动数据窗口控件中的数据时触发ScrollVertical当用户使用Tab键、箭头键、或滚动条上下移动数据窗口控件中的数据时触发SQLPreview在调用Retrieve（），Update（）或ReselectRow（）函数后、SQL语句被发送到DBMS前发生。由Update（）函数触发该事件时，该事件返回值的意义为：0-继续更新；1-停止更新；2-跳过本次请求继续进行UpdateEnd当数据窗口更新了数据库后触发UpdateStart调用Update（）函数后、修改数据库数据前触发。该事件返回值的意义为：0-（缺省值）继续更新；1-不执行更新 5.3数据窗口控件的函数函数返回值功能AcceptTextInteger将数据窗口控件中“漂浮”在当前行/列上的编辑框的内容放入数据窗口缓冲区的当前项中（编辑框的内容必须通过数据有效性规则检查）CanUndoBoolean检测最近一次编辑操作能否被撤消。返回值为True时能够撤消，为False时不能撤消CategoryCountInteger返回数据窗口控件指定统计图的数据类别数CategoryNameString返回数据窗口控件指定统计图的数据类别名称ClassNameString返回数据窗口控件的名称ClearInteger删除数据窗口控件的编辑框中所选内容，对RichText风格数据窗口来说，删除数据窗口中所选内容ClearValuesInteger删除数据窗口控制指定列的代码表中的所有值，该函数不影响指定列的数据值ClipBoardInteger将数据窗口控件指定列的统计图复制到系统剪贴板CopyInteger将数据窗口控件当前行列上编辑框中的所选内容复制到系统剪贴板。对RichText风格的数据窗口来说，把数据窗口控件中所选内容 到系统剪贴板CopyRTFString将数据窗口控件中所选的文本、图像、输入字段作为一个文本格式的字符串返回，位图和输入字段包括在字符串中CreateInteger使用指定的源代码创建数据窗口对象，并用新的数据窗口对象取代数据窗口控件中原有的数据窗口对象CrosstabDialogInteger显示“Crosstab Definition”对话框，这样用户能够在运行时修改Crosstab风格的数据窗口对象的定义CutInteger将数据窗口控件当前行列上编辑框中的所选内容剪切掉并保存到系统剪贴板上。对RichText风格的数据窗口来说，把数据窗口控件中所选内容剪切到系统剪切板DataCountLong返回值数据窗口控件指定图形、指定序列的数据点数DBCancelInteger取消数据库数据检索进程DBErrorCodeLong得到数据库访问出错时的错误编号（即将废弃）DBErrorMessageString得到数据库访问出错时的错误信息（即将废弃）DeletedCountLong返回数据窗口控件中已经被删除但尚未做数据库更新的行的数量DeleteRowInteger删除数据窗口控件中指定的行DescribeString返回数据窗口控件的指定信息DragInteger开始或结束数据窗口控件的拖动FilterInteger在数据窗口控件中显示满足当前过滤条件的行FilteredCountInteger返回过滤缓冲区中数据行数FindLong语法1：在数据窗口控件中查找满足条件的下一行。语法2：对RichText风格的数据窗口来说，在该控件中查找满足条件的文本，如果找到的话，就将其加亮。可以指定查找方向以及指定是否需要大小写匹配FindGroupChangeLon