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
Commctrl.h