LVM_SORTITEMSEX訊息

  • 發行項

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

參數

wParam

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

lParam

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

傳回值

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

備註

比較函式的格式如下：

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

此訊息類似于 LVM_SORTITEMS，但傳遞給比較函式的資訊類型除外。 使用 LVM_SORTITEMSEX， lParam1 是第一個專案的目前索引， 而 lParam2 是第二個專案的目前索引。 您可以視需要傳送 LVM_GETITEMTEXT 訊息，以擷取專案的詳細資訊。

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

注意

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

規格需求

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