LVM_SORTITEMSEX メッセージ

アプリケーション定義の比較関数を使用して、リスト ビュー コントロールの項目を並べ替えます。 各項目のインデックスは、新しいシーケンスを反映するように変更されます。 このメッセージは、明示的に送信することも、 ListView_SortItemsEx マクロを使用して送信することもできます。

パラメーター

wParam

比較関数に渡されるアプリケーション定義値。

lParam

アプリケーション定義比較関数へのポインター。 2 つのリスト アイテムの相対順序を比較する必要があるたびに、並べ替え操作中に呼び出されます。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。

解説

比較関数の形式は次のとおりです。

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

このメッセージは、比較関数に渡される情報の種類を除き、 LVM_SORTITEMSに似ています。 LVM_SORTITEMSEXでは、lParam1 は最初の項目の現在のインデックスであり、lParam2 は 2 番目の項目の現在のインデックスです。 LVM_GETITEMTEXT メッセージを送信して、必要に応じてアイテムに関する詳細情報を取得できます。

比較関数は、最初の項目が 2 番目の項目の前にある場合は負の値を返し、最初の項目が 2 番目の項目の後に続く場合は正の値を返し、2 つの項目が等しい場合は 0 を返す必要があります。

Note

並べ替え処理中に、リスト ビューの内容が不安定になります。 コールバック関数が、 LVM_GETITEM (ListView_GetItem) 以外のメッセージをリスト ビュー コントロールに送信する場合、結果は予測できません。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Commctrl.h