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()