LVM_SORTITEMSEX Nachricht

Verwendet eine anwendungsdefinierte Vergleichsfunktion, um die Elemente eines Listenansicht-Steuerelements zu sortieren. Der Index jedes Elements ändert sich, um die neue Sequenz widerzuspiegeln. Sie können diese Nachricht explizit oder mithilfe des Makros ListView_SortItemsEx senden.

Parameter

wParam

Anwendungsdefinierter Wert, der an die Vergleichsfunktion übergeben wird.

lParam

Zeiger auf eine anwendungsdefinierte Vergleichsfunktion. Es wird während des Sortiervorgangs jedes Mal aufgerufen, wenn die relative Reihenfolge von zwei Listenelementen verglichen werden muss.

Rückgabewert

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE .

Bemerkungen

Die Vergleichsfunktion hat die folgende Form:

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

Diese Meldung ähnelt LVM_SORTITEMS, mit Ausnahme des Informationstyps, der an die Vergleichsfunktion übergeben wird. Bei LVM_SORTITEMSEX ist lParam1 der aktuelle Index des ersten Elements und lParam2 der aktuelle Index des zweiten Elements. Sie können bei Bedarf eine LVM_GETITEMTEXT Nachricht senden, um weitere Informationen zu einem Element abzurufen.

Die Vergleichsfunktion muss einen negativen Wert zurückgeben, wenn das erste Element dem zweiten vorangestellt werden soll, einen positiven Wert, wenn das erste Element dem zweiten element folgen soll, oder null, wenn die beiden Elemente gleichwertig sind.

Hinweis

Während des Sortierungsprozesses ist der Inhalt der Listenansicht instabil. Wenn die Rückruffunktion außer LVM_GETITEM (ListView_GetItem) Nachrichten an das Listenansichtssteuerelement sendet, sind die Ergebnisse unvorhersehbar.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h