LVM_SORTITEMS訊息

使用應用程式定義的比較函式來排序清單檢視控制項的專案。 每個專案的索引會變更以反映新的順序。 您可以明確傳送此訊息，或使用 ListView_SortItems 宏。

參數

wParam

傳遞至比較函式的應用程式定義值。

lParam

應用程式定義比較函式的指標。 每次需要比較兩個清單專案的相對順序時，都會在排序作業期間呼叫比較函式。

傳回值

如果成功，則傳回 TRUE ，否則傳回 FALSE 。

備註

比較函式的格式如下：

int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);

lParam1參數是與要比較的第一個專案相關聯的值，而 lParam2參數則是與第二個專案相關聯的值。 這些是在專案LVITEM結構的lParam成員中指定的值，這些值是在插入清單中時所指定的。 ListView_SortItems的wParam參數會傳遞至回呼函式做為其第三個參數。

如果第一個專案應該在第二個專案前面，則比較函式必須傳回負值，如果第一個專案應該遵循第二個專案，則傳回正值，如果兩個專案相等，則為零。

注意

在排序過程中，清單檢視內容是不穩定的。 如果回呼函式將任何訊息傳送至清單檢視控制項，除了 LVM_GETITEM (ListView_GetItem) 之外，結果將無法預期。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	Commctrl.h