PowerBuilder 8 数据窗口对象函数.docx

PowerBuilder 8 数据窗口对象函数.docx

《PowerBuilder 8 数据窗口对象函数.docx》由会员分享，可在线阅读，更多相关《PowerBuilder 8 数据窗口对象函数.docx（81页珍藏版）》请在冰豆网上搜索。

PowerBuilder8数据窗口对象函数

PowerBuilder8

数据窗口对象函数

数据窗口对象常用函数：

ClassName

Modify

GetItemTime

GetItemStatus

GetValidate

TypeOf

GetNextModified

GetItemDateTime

SetItemStatus

SetValidate

GetParent

GetSQLSelect

GetItemDecimal

ResetUpdate

GetValue

GetChild

SetSQLSelect

GetItemNumber

Scroll

SetValue

GetBorderStyle

GetTrans

GetItemString

ScrollNextPage

ClearValues

SetBorderStyle

SetTrans

SetItem

ScrollNextRow

GetText

SetTabOrder

SetTransObject

RowsCopy

ScrollPriorPage

SetText

SetFocus

ResetTransObject

RowsMove

ScrollPriorRow

SelectText

PointerX

ImportClipboard

RowsDiscard

ScrollToRow

SelectedText

PointerY

ImportFile

ShareData

GetRow

SelectedLength

SetPosition

ImportString

ShareDataOff

SetRow

SelectedLine

Drag

SaveAs

InsertRow

GetColumn

TextLine

Move

Retrieve

DeleteRow

SetColumn

LineCount

Resize

Reset

SetFilter

GetColumnName

Copy

SetRedraw

Update

Filter

Find

Cut

Hide

DBCancel

SetSort

SetRowFocusIndicator

Paste

Show

DBErrorCode

Sort

SelectRow

Clear

TriggerEvent

DBErrorMessage

RowCount

GetSelectedRow

ReplaceText

PostEvent

Print

ModifiedCount

IsSelected

AcceptText

Create

PrintCancel

FilteredCount

GetFormat

CanUndo

Describe

GetItemDate

DeletedCount

SetFormat

Undo

总计：

105

1、Dwcontrol.ClassName（

功能描述：

得到对象继承层次中当前层次的类名。

语法说明：

dwcontrol：

数据窗口控件名；

返回值：

String类型。

①如果执行成功，则返回对象继承层次中当前层次的类名；

②如果发生错误，则返回空串（""）；

③如果任何参数的值为NULL，则该函数返回NULL；

用法：

当某个祖先对象以其后继对象的方式实例化时，使用ClassName（函数可以得到后继对象的名称。

2、Dwcontrol.TypeOf（

功能描述：

得到对象继承层次中最高层次的类名。

语法说明：

dwcontrol：

数据窗口控件名；

返回值：

Object枚举数据类型。

①如果执行成功，则返回对象继承层次中最高层次的类名；

②如果任何参数的值为NULL，则该函数返回NULL；

3、Dwcontrol.GetParent（

功能描述：

得到指定对象的父对象引用。

语法说明：

dwcontrol：

数据窗口控件名；

返回值：

PowerObject类型。

该函数返回指向dwcontrol父对象的引用（指针）。

4、Dwcontrol.GetChild（name,dwchildvariable

功能描述：

得到指定对象的子数据窗口引用。

语法说明：

①dwcontrol：

数据窗口控件名；

②name：

String类型，列名，该列包含了欲得到引用的子数据窗口对象；

③dwchildvariable：

DataWindowChild类型，用于存储该函数得到的子数据窗口对象的引用。

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

用法：

这里所说的子数据窗口包括两方面的意义：

一是数据窗口对象中的下拉数据窗口（DropDownDataWindow）；

一是复合风格数据窗口对象中的子报表；

需要注意的是，在创建复合风格的数据窗口对象时，它使用的子报表（实际上也是个数据窗口对象）必须要设置其Name属性，否则就不能使用GetChild（函数来得到该子报表的引用。

5、Dwcontrol.GetBorderStyle（column

功能描述：

得到数据窗口控件指定列的边框类型。

语法说明：

①dwcontrol：

数据窗口控件名；

②column：

要得到边框类型的列，column参数可以使用列名（String类型），也可以使用列号（Integer类型）；

返回值：

Border类型。

①如果执行成功，返回数据窗口控件中column列的边框类型，用Border枚举类型的量表示，其有效取值为：

[Box!

]：

方框

[Lowered!

]：

三维下凹

[NoBorder!

]：

无边框

[Raised!

]：

三维上凸

[ResizeBorder!

]：

可变大小边框

[ShadowBox!

]：

阴影

[Underline!

]：

下划线

②如果任何参数的值为NULL，则该函数返回NULL；

6、Dwcontrol.SetBorderStyle（column,borderstyle

功能描述：

设置数据窗口控件指定列的边框风格。

语法说明：

①dwcontrol：

数据窗口控件名；

②column：

要设置边框类型的列。

column参数可以使用列名（String类型），也可以使用列号（Integer类型）；

③borderstyle：

Border枚举数据类型，指定要设置的边框类型，其有效取值为：

[Box!

]：

方框

[Lowered!

]：

三维下凹

[NoBorder!

]：

无边框

[Raised!

]：

三维上凸

[ResizeBorder!

]：

可变大小边框

[ShadowBox!

]：

阴影

[Underline!

]：

下划线

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

7、Dwcontrol.SetTabOrder（column,tabnumber

功能描述：

修改数据窗口控件指定列的跳转次序（Tab次序）。

语法说明：

①dwcontrol：

数据窗口控件名；

②column：

指定要设置跳转次序的列。

column参数可以使用列名（String类型），也可以使用列号（Integer类型）；

③tabnumber：

0~9999之间的一个数字，该数字将作为指定列的跳转序号。

如果将该参数设置为0，则column参数指定的列将不可更新，同时该列也无法得到输入焦点；

返回值：

Integer类型。

①如果执行成功，则返回指定列先前的跳转序号；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

8、Dwcontrol.SetFocus（

功能描述：

将焦点设置到指定控件上。

语法说明：

dwcontrol：

数据窗口控件名；

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

9、Dwcontrol.PointerX（

功能描述：

确定鼠标指针离指定对象左边缘的距离。

语法说明：

dwcontrol：

数据窗口控件名；

返回值：

Integer类型。

①如果执行成功，则返回鼠标指针离dwcontrol左边缘的距离（以PBU为单位）；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

10、Dwcontrol.PointerY（

功能描述：

确定鼠标指针离指定对象上边缘的距离。

语法说明：

dwcontrol：

数据窗口控件名；

返回值：

Integer类型。

①如果执行成功，则返回鼠标指针离dwcontrol上边缘的距离（以PBU为单位）；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

11、Dwcontrol.SetPosition（position{,precedingobject}

功能描述：

指定数据窗口控件在窗口中显示的前后次序。

语法说明：

①dwcontrol：

数据窗口控件名；

②position：

SetPosType枚举型值，该参数的取值为：

[Behind!

]：

把dwcontrol控件放置到precedingobject对象的后面；

[ToTop!

]：

把dwcontrol控件放置到所有控件的前面；

[ToBottom!

]：

把dwcontrol控件放置到所有控件的后面；

③precedingobject：

可选参数，当position参数取值为Behind!

时，需要指定precedingobject参数，其作用是把指定控件放置到precedingobject控件的后面。

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

12、Dwcontrol.Drag（dragmode

功能描述：

开始或结束控件的拖曳操作。

语法说明：

①dwcontrol：

数据窗口控件名；

②dragmode：

指定希望进行的拖曳操作类型，该参数是个DragMode类型的值，各值的意义为：

[Begin!

]：

进入拖曳模式；

[Cancel!

]：

停止拖曳操作，但不触发DragDrop事件；

[End!

]：

停止拖曳操作，如果被拖曳控件位于某个拖曳操作的目的对象上，那么触发该对象的DragDrop事件；

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

13、Dwcontrol.Move（x,y

功能描述：

把数据窗口控件移动到指定的位置（相对于其所处的父窗口）；

语法说明：

①dwcontrol：

数据窗口控件名；

②x：

移动后新位置的x坐标，以PBU为单位；

③y：

移动后新位置的y坐标，以PBU为单位；

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

用法：

Move（函数与直接修改控件或对象的X、Y属性的最终效果相同，但两者之间存在一些性能上的差异：

使用Move（函数只需重绘一次控件或对象，而直接修改X、Y属性需要重绘2次控件或对象。

14、Dwcontrol.Resize（width,height

功能描述：

改变数据窗口控件的大小，该函数首先修改数据窗口的Width（宽度）和Height（高度）属性，之后重绘该控件或对象。

语法说明：

①dwcontrol：

数据窗口控件名；

②width：

修改后的对象或控件的宽度，以PBU为单位；

③height：

修改后的对象或控件的高度，以PBU为单位；

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

用法：

Resize（函数与直接修改数据窗口控件的Width、Height属性的最终效果相同，但两者之间存在一些性能上的差异：

使用Resize（函数只需重绘1次数据窗口控件，而直接修改Width、Height属性需要重绘2次。

15、Dwcontrol.SetRedraw（boolean

功能描述：

指定每次修改控件属性后是否自动重绘控件。

语法说明：

①dwcontrol：

数据窗口控件名；

②boolean：

Boolean型值，指定修改数据窗口控件的属性后是否自动重绘该控件。

有效取值为：

[TRUE]：

修改属性后自动重绘数据窗口控件，默认值；

[FALSE]：

修改属性后不自动重绘数据窗口控件；

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

16、Dwcontrol.Hide（

功能描述：

隐藏数据窗口控件。

语法说明：

dwcontrol：

数据窗口控件名；

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

17、Dwcontrol.Show（

功能描述：

显示数据窗口控件。

语法说明：

dwcontrol：

数据窗口控件名；

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

18、Dwcontrol.TriggerEvent（event{,word,long}

功能描述：

TriggerEvent（用于同步触发指定对象的事件处理程序。

语法说明：

①dwcontrol：

数据窗口控件名；

②event：

要触发的事件，其有效值既可以是标识PowerBuilder预定义事件的TrigEvent枚举类型值（比如：

Clicked!

、Modified!

或DoubleClicked!

等）、也可以是表示事件名称的字符串（例如：

用户自定义事件"cb_exit_request"）。

需要注意的是，该事件必须是dwcontrol对象的有效事件，且必须已经编写了该事件的事件处理程序。

③word：

Long型值，是个可选参数，事件发生后其值将保存到系统全局对象Message的WordParm属性中，用于传递事件的word参数。

如果只想指定long参数的值，那么将word参数置为0；

④long：

Long型值，是个可选参数，事件发生后其值将保存到系统全局对象Message的LongParm属性中，用于传递事件的long参数。

当在该参数中指定一个字符串时，指向该字符串的指针被保存到系统全局对象Message的LongParm属性中，在事件处理程序中使用String（函数可以得到该参数提供的字符串。

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果指定的事件不是dwcontrol的有效事件或指定的事件未编写事件处理程序，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

用法：

如果long参数被指定为一个字符串，那么在事件处理程序中使用String（函数得到该字符串，此时，需要用关键字"address"作为String（函数的格式参数。

得到字符串参数的事件处理程序可以写成如下形式：

SringPassedString

PassedString=String（Message.LongParm,"address"

只有在long参数中包括有效的字符串时才能使用上述写法。

19、Dwcontrol.PostEvent（event{,word,long}

功能描述：

PostEvent（用于异步触发指定对象的事件处理程序。

语法说明：

①dwcontrol：

数据窗口控件名；

②event：

要触发的事件，其有效值既可以是标识PowerBuilder预定义事件的TrigEvent枚举类型值（比如：

Clicked!

、Modified!

或DoubleClicked!

等）、也可以是表示事件名称的字符串（例如：

用户自定义事件"cb_exit_request"）。

需要注意的是，该事件必须是dwcontrol对象的有效事件，且必须已经编写了该事件的事件处理程序。

③word：

Long型值，是个可选参数，事件发生后其值将保存到系统全局对象Message的WordParm属性中，用于传递事件的word参数。

如果只想指定long参数的值，那么将word参数置为0；

④long：

Long型值，是个可选参数，事件发生后其值将保存到系统全局对象Message的LongParm属性中，用于传递事件的long参数。

当在该参数中指定一个字符串时，指向该字符串的指针被保存到系统全局对象Message的LongParm属性中，在事件处理程序中使用String（函数可以得到该参数提供的字符串。

返回值：

Boolean类型。

①函数执行成功时，则返回TRUE；

②如果指定的事件不是dwcontrol的有效事件或指定的事件未编写事件处理程序，则返回FALSE；

③如果任何参数的值为NULL，则该函数返回NULL；

用法：

如果long参数被指定为一个字符串，那么在事件处理程序中使用String（函数得到该字符串，此时，需要用关键字"address"作为String（函数的格式参数。

得到字符串参数的事件处理程序可以写成如下形式：

SringPassedString

PassedString=String（Message.LongParm,"address"

只有在long参数中包括有效的字符串时才能使用上述写法。

20、Dwcontrol.Create（syntax{,errorbuffer}

功能描述：

动态创建数据窗口对象。

使用指定的源代码创建数据窗口对象，并用新的数据窗口对象取代数据窗口控件中原有的数据窗口对象。

用这种方法创建的数据窗口对象不会自动成为应用库的一部分。

语法说明：

①dwcontrol：

数据窗口控件名；

②syntax：

数据窗口对象源代码，Create（函数将使用该代码来创建数据窗口对象；

③errorbuffer：

可选参数，它用于保存创建数据窗口对象过程中出错时的出错信息。

如果省略了该参数，那么出错时系统将使用消息对话框显示出错信息。

返回值：

Integer类型。

①如果执行成功，则返回1；

②如果发生错误，则返回-1；

③如果任何参数的值为NULL，则该函数返回NULL；

用法：

Create（函数使用syntax参数指定的数据窗口对象源代码创建数据窗口对象，新创建的数据窗口对象将取代与数据窗口控件相关联的当前数据窗口对象。

21、Dwcontrol.Describe（propertylist

功能描述：

返回数据窗口控件结构方面的指定信息，包括DataWindow对象以及数据窗口对象中其他对象的属性取值。

数据窗口中的每个列、每个标题等等都是对象，各自都有一组描述其特征的属性。

在Describe（函数的参数中可以通过字符串指定要得到其值的一组属性，该函数将会把它们的值作为一个字符串返回。

语法说明：

①dwcontrol：

数据窗口控件名；

②propertylist：

属性列表，是个字符串，由要查看其取值的一个或多个属性或表达式组成，属性以及表达式之间使用空格分隔。

这里的属性指数据窗口对象的属性。

在Describe（函数的参数中引用数据窗口对象属性的一般语法为：

objectname.property

返回值：

String类型。

①该函数返回一个字符串，这个字符串由对应于propertylist中各属性的具体取值构成，各属性值之间使用换行字符（~n）分隔；

②如果属性列表中包含了无效的项（比如拼错了属性名或写错了表达式），那么Describe（函数在相应项的位置返回一个惊叹号（!

），并忽略随后的所有项。

当某个属性没有值时，Describe（函数在相应位置返回一个问号（?

）。

如果某个属性的值是个问号（?

），那么Describe（函数将在该项位置返回问号，并把问号放置到引号中（通常为单引号'）；

③如果任何参数的值为NULL，则该函数返回NULL；

用法：

①应用程序中经常使用Describe（函数得到数据窗口当前的SELECT语句，然后根据需要进行修改，比如增加WHERE子句，修改排序方式等。

当开发人员使用数据窗口画笔以图形化方式创建数据窗口对象（选择了操作数据库的数据源）后，实际上就定义了某个SELECT语句。

在保存数据窗口对象时，PowerBuilder保存的不是标准的SQLSELECT语句，而是以它自己定义格式的SELECT语句（称做PBSELECT语句）与数据窗口对象保存在一起。

当应用程序使用Describe（函数得到Table.Select属性的值时，如果应用程序已经连接到数据库上，那么Describe（函数返回SQLSELECT语句；如果应用程序尚未连接到数据库上，那么Describe（函数返回PBSELECT语句。

②当应用程序要查看某个列的属性时，可以使用列名，也可以使用列号。

使用列号时，在列号前放上#号。

例如，Name是某个数据窗口的第2列，那么语句：

Name=dw_1.Describe（"Name.coltype"

与

Name=dw_1.Describe（"#2.coltype"

等价。

③可以把Evaluate（函数作为Describe（函数的参数来计算数据窗口画笔表达式的值。

Evaluate（函数的语法格式为：

Evaluate（'expression',rownumber

这里，expression是希望计算其值的数据窗口画笔表达式，rownumber是数据行的行号，画笔表达式根据该行的数据计算其值。

在画笔表达式中可以使用数据窗口画笔函数。

22、Dwcontrol.Modify（modstring

功能描述：

使用字符串中定义的操作修改数据窗口控件。

语法说明：

①dwcontrol：

数据窗口控件名；

②modstring：

String