LVM_SORTITEMS 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_SortItems senden.

Parameter

wParam

Anwendungsdefinierter Wert, der an die Vergleichsfunktion übergeben wird.

lParam

Zeiger auf die anwendungsdefinierte Vergleichsfunktion. Die Vergleichsfunktion 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);

Der Parameter lParam1 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-Element der LVITEM-Struktur der Elemente angegeben wurden, als sie in die Liste eingefügt wurden. Der wParam-Parameter des ListView_SortItems wird als dritter Parameter an die Rückruffunktion übergeben.

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