PB日志-数据窗口控件函数142.Sort()

 

Sort
 
 
功能

根据当前的排序条件排序数据窗口控件的行。
语法

dwcontrol.Sort ( )
参数

dwcontrol：数据窗口控件名
返回值

Integer。函数执行成功时返回 1，发生错误时函数返回-1。如果 dwcontrol 的值为NULL，则 Sort()函数返回 NULL。
用法

       Sort()按照数据窗口 dwcontrol 当前设置的排序条件排序数据窗口中的数据。要修 改数据窗口的排序条件，请使用数据窗口控件的对象函数 SetSort()。Sort()函数 的功能与数据窗口画笔中从“Rows”菜单中选择“Sort”菜单项的作用相同。 如果在调用 Sort()函数之前没有执行 SetSort()函数，那么 Sort()函数就使用定义 数据窗口对象时指定的排序条件。
       在应用程序执行 Retrieve()函数为数据窗口提取数据时，如果数据窗口对象 定义了排序条件，那么 PowerBuilder 就直接完成排序任务。只有在应用程序修 改了排序条件、或由于应用程序的某些操作或用户输入改变了数据且需要重新 排序数据时，才需要执行 Sort()函数。

       如果数据窗口设置了“Retrieve As Needed”（按需提取数据）选项，那么 Sort() 函数的执行就取消了该选项的效果。执行 Sort()函数时，总是要提取出数据窗口 的所有数据。
       对复合报表的数据窗口来说，Sort()函数无效。
       如果要排序带分组的数据窗口对象，那么在执行 Sort() 函数后，执行GroupCalc()函数，以保持正确的数据分组。
代码实例：
例 1. 下面的代码是排序带分组数据窗口的一个示例，其中使用 SetRedraw()函数 的目的是为了提高程序执行效率、减少屏幕闪烁：
dw_depts.SetRedraw(false)

dw_depts.Sort()

dw_depts.GroupCalc()

dw_depts.SetRedraw(true)