ListView_SortItems巨集（commctrl.h）

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

語法

BOOL ListView_SortItems(
   HWND         hwndLV,
   PFNLVCOMPARE _pfnCompare,
   LPARAM       _lPrm
);

hwndLV

類型：HWND

清單檢視控件的句柄。

_pfnCompare

類型：PFNLVCOMPARE

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

_lPrm

類型：LPARAM

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

類型：BOOL

如果成功，則傳回 true true，否則會 傳回 false。

比較函式的格式如下。

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

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

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

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