LVM _ SORTITEMS-Nachricht
Verwendet eine anwendungsdefinierte Vergleichsfunktion, um die Elemente eines Listenansicht-Steuerelements zu sortieren. Der Index der einzelnen Elemente ändert sich entsprechend der neuen Sequenz. Sie können diese Nachricht explizit oder mithilfe des _ SortItems-Makros listview senden.
Parameter
-
wParam
-
Anwendungsdefinierter Wert, der an die Vergleichsfunktion übergeben wird.
-
lParam
-
Zeiger auf die anwendungsdefinierte Vergleichsfunktion. Die Vergleichsfunktion wird während des Sortiervorgang jedes Mal aufgerufen, wenn die relative Reihenfolge von zwei Listenelementen verglichen werden muss.
Rückgabewert
Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE.
Hinweise
Die Vergleichsfunktion hat die folgende Form:
int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);
Der lParam1-Parameter ist der Wert, der dem ersten verglichenen Element zugeordnet ist, und der lParam2-Parameter ist der Wert, der dem zweiten Element zugeordnet ist. Dies sind die Werte, die im lParam-Member der LVITEM-Struktur der Elemente angegeben wurden, als sie in die Liste eingefügt wurden. Der wParam-Parameter von ListView _ SortItemswird als dritter Parameter an die Rückruffunktion übergeben.
Die Vergleichsfunktion muss einen negativen Wert zurückgeben, wenn das erste Element vor dem zweiten Element stehen soll, einen positiven Wert, wenn das erste Element dem zweiten element folgen soll, oder 0 (null), wenn die beiden Elemente gleichwertig sind.
Hinweis
Während des Sortiervorgangs sind die Inhalte der Listenansicht instabil. Wenn die Rückruffunktion Nachrichten an das Listenansicht-Steuerelement sendet, abgesehen von LVM _ GETITEM (ListView _ GetItem),sind die Ergebnisse unvorhersehbar.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|