LVM_SORTITEMS メッセージ
アプリケーション定義の比較関数を使用して、リスト ビュー コントロールの項目を並べ替えます。 各項目のインデックスは、新しいシーケンスを反映するように変更されます。 このメッセージは、明示的に送信することも、 ListView_SortItems マクロを使用して送信することもできます。
パラメーター
-
wParam
-
比較関数に渡されるアプリケーション定義値。
-
lParam
-
アプリケーション定義比較関数へのポインター。 比較関数は、2 つのリスト アイテムの相対順序を比較する必要があるたびに、並べ替え操作中に呼び出されます。
戻り値
成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。
解説
比較関数の形式は次のとおりです。
int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);
lParam1 パラメーターは比較対象の最初の項目に関連付けられた値であり、lParam2 パラメーターは 2 番目の項目に関連付けられた値です。 これらは、項目の LVITEM 構造体の lParam メンバーがリストに挿入されたときに指定された値です。 ListView_SortItemsの wParam パラメーターは、3 番目のパラメーターとしてコールバック関数に渡されます。
比較関数は、最初の項目が 2 番目の項目の前にある場合は負の値を返し、最初の項目が 2 番目の項目の後に続く場合は正の値を返し、2 つの項目が等価である場合は 0 を返す必要があります。
注意
並べ替え処理中に、リスト ビューの内容が不安定になります。 コールバック関数が、 LVM_GETITEM (ListView_GetItem) を除いてリスト ビュー コントロールにメッセージを送信すると、結果は予測できません。
必要条件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
ヘッダー |
|