函数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”(按需提取数据)选项(Rows->Retrieve option->Retrieve As Needed),那么Sort()函数的执行就取消了该选项的效果。执行Sort()函数时,总是要提取数据窗口的所有数据。
对复合报表的数据窗口来说,Sort()函数无效。
如果要排序带分组的数据窗口对象,那么在执行Sort()函数后,执行GroupCalc()函数,以保持正确的数据分组。