ListView_SortItems Makro (commctrl.h)

Verwendet eine anwendungsdefinierte Vergleichsfunktion, um die Elemente eines Listenansichtssteuerelements zu sortieren. Der Index der einzelnen Elemente ändert sich, um die neue Sequenz widerzuspiegeln. Sie können dieses Makro verwenden oder die LVM_SORTITEMS Nachricht explizit senden.

Syntax

BOOL ListView_SortItems(
   HWND         hwndLV,
   PFNLVCOMPARE _pfnCompare,
   LPARAM       _lPrm
);

Parameter

hwndLV

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

_pfnCompare

Typ: PFNLVCOMPARE

Ein 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.

_lPrm

Typ: LPARAM-

Der anwendungsdefinierte Wert, der an die Vergleichsfunktion übergeben wird.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

Die Vergleichsfunktion weist das folgende Formular auf.

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

Der parameter lParam1 ist der Wert, der dem ersten verglichenen Element zugeordnet ist; und der lParam2 Parameter ist der dem zweiten Element zugeordnete Wert. Dies sind die Werte, die im lParam- Element der LVITEM- Struktur angegeben wurden, als sie in die Liste eingefügt wurden. Der parameter _lPrm ist derselbe Wert, der an die LVM_SORTITEMS Nachricht übergeben wird.

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

Anforderungen