SetSort，一種函式，用來定義數據視窗控制項的排序條件。
基本介紹
- 外文名：SetSort
- 作用：用來定義數據視窗控制項的排序條件
- 函式語法： dwcontrol.SetSort ( format )
z dwcontrol：數據視窗控制項名
z 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
