ListView_SortItems宏 (commctrl.h)

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

語法

void ListView_SortItems(
   hwndLV,
   _pfnCompare,
   _lPrm
);

hwndLV

類型： HWND

清單檢視控件的句柄。

_pfnCompare

類型： PFNLVCOMPARE

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

_lPrm

類型： LPARAM

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

無

比較函式的格式如下。

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

lParam1 參數是與要比較的第一個專案相關聯的值;和 lParam2 參數是與第二個專案相關聯的值。這些是在專案 LVITEM 結構的 lParam 成員中指定的值，這些值是在插入清單中時所指定的。 lParamSort 參數是傳遞至LVM_SORTITEMS訊息的相同值。

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

注意在排序過程中，清單檢視內容是不穩定的。如果回呼函式將任何訊息傳送至清單檢視控件，則結果無法預測。