PB日志-数据窗口控件函数130.SetSort()

SetSort
功能

定义数据窗口控件的排序条件。
语法

dwcontrol.SetSort ( format )
参数

dwcontrol:数据窗口控件名
 format:string  类型,其值是有效的排序条件。排序条件中可以使用 列名或列号,使用列号时,在列号前加上个#符号。如果 format 参数 的值为 NULL,那么程序运行时 PowerBuilder 会提醒用户输入排序条 件
返 回 值

 Integer。函数执行成功时返回 1,发生错误时返回-1。
用法

       在定义数据窗口对象时,可以同时定义排序条件。当使用函数 SetSort()定义新的排序条件后,新的排序条件将取代原有的排序条件。但是,执行 SetSort()函数后, 数据窗口并没有真正排序数据。要完成排序工作,需要执行数据窗口控件的对 象函数 Sort()。
       按某列排序时,在排序条件中放上列名或列号,后跟上“A”或“D”指明 排序方式。其中“A”表示升序,“D”表示降序。要按多个列排序时,在每个 列的排序条件之间用逗号(,)分隔。下面是两个排序条件示例:
"emp_lname A" "emp_lname A, dept_id D" 

        如果想让用户在程序运行时指定排序条件,那么可以这样做:以空值作为SetSort() 函数的参数来调用 SetSort() 。程序运 行时, PowerBuilder  会显 示 “SpecifySort Columns”对话框,让用户指定排序方式。之后调用 Sort()函数完 成实际排序。
 代码实例:
例 1. 下面的语句为数据窗口控件 dw_employee 定义排序条件,该条件的意义为: 按 emp_status 列升序排序,按 emp_salary 列降序排序:
dw_employee.SetSort("emp_status A, emp_salary D")
示例 2. 下面的语句为数据窗口控件 dw_emp 设置了按 emp_status 列升序排序、 按 emp_salary 列降序排序的排序条件,然后调用 Sort()函数完成实际排序工作:
string ls_newsort
newsort = "emp_status A, emp_salary D"

 dw_emp.SetSort (newsort)

 dw_emp.Sort()

你可能感兴趣的:(PowerBuilder)