WM_COMPAREITEM Nachricht

  • Artikel

Gesendet, um die relative Position eines neuen Elements in der sortierten Liste eines vom Besitzer gezeichneten Kombinationsfelds oder Listenfelds zu bestimmen. Jedes Mal, wenn die Anwendung ein neues Element hinzufügt, sendet das System diese Nachricht an den Besitzer eines Kombinationsfelds oder Listenfelds, das mit dem CBS_SORT oder LBS_SORT Stil erstellt wurde.

WM_COMPAREITEM

    WPARAM wParam;
    LPARAM lParam;

Parameter

wParam

Gibt den Bezeichner des Steuerelements an, das die WM_COMPAREITEM Nachricht gesendet hat.

lParam

Zeiger auf eine COMPAREITEMSTRUCT-Struktur , die die Bezeichner und von der Anwendung bereitgestellten Daten für zwei Elemente im Kombinations- oder Listenfeld enthält.

Rückgabewert

Der Rückgabewert gibt die relative Position der beiden Elemente an. Es kann sich um einen der in der folgenden Tabelle gezeigten Werte handeln.

Rückgabecode Beschreibung
Wert
 Bedeutung
-1
 Element 1 steht in der sortierten Reihenfolge vor Element 2.
0
 Die Elemente 1 und 2 sind in der sortierten Reihenfolge gleichwertig.
1
 Element 1 folgt auf Element 2 in der sortierten Reihenfolge.

Bemerkungen

Wenn der Besitzer eines vom Besitzer gezeichneten Kombinationsfelds oder Listenfelds diese Meldung empfängt, gibt der Besitzer einen Wert zurück, der angibt, welche der von der COMPAREITEMSTRUCT-Struktur angegebenen Elemente vor dem anderen angezeigt werden. In der Regel sendet das System diese Nachricht mehrmals, bis es die genaue Position für das neue Element bestimmt.

Wenn eine Dialogfeldprozedur diese Meldung verarbeitet, sollte sie den gewünschten Rückgabewert in einen BOOL umwandeln und den Wert direkt zurückgeben. Der von der SetWindowLong-Funktion festgelegte DWL_MSGRESULT Wert wird ignoriert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur Desktop-Apps]
Header
Winuser.h (windows.h einschließen)

Siehe auch

Referenz

COMPAREITEMSTRUCT

Andere Ressourcen

SetWindowLong