LB_FINDSTRINGEXACT Nachricht
Sucht die erste Listenfeldzeichenfolge, die genau mit der angegebenen Zeichenfolge übereinstimmt, mit dem Unterschied, dass bei der Suche die Groß-/Kleinschreibung nicht beachtet wird.
Parameter
-
wParam
-
Der nullbasierte Index des Elements vor dem ersten zu durchsuchenden Element. Wenn die Suche das ende des Listenfelds erreicht, wird die Suche vom oberen Rand des Listenfelds zurück zu dem durch den wParam-Parameter angegebenen Element fortgesetzt. Wenn wParam -1 ist, wird das gesamte Listenfeld von Anfang an durchsucht.
Windows 95/Windows 98/Windows Millennium Edition (Windows Me): Der wParam-Parameter ist auf 16-Bit-Werte beschränkt. Dies bedeutet, dass Listenfelder nicht mehr als 32.767 Elemente enthalten dürfen. Obwohl die Anzahl der Elemente eingeschränkt ist, ist die Gesamtgröße der Elemente in einem Listenfeld nur durch den verfügbaren Arbeitsspeicher begrenzt.
-
lParam
-
Ein Zeiger auf die NULL-Zeichenfolge, nach der gesucht werden soll. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet, sodass diese Zeichenfolge eine beliebige Kombination aus Groß- und Kleinbuchstaben enthalten kann.
Rückgabewert
Der Rückgabewert ist der nullbasierte Index des übereinstimmenden Elements oder LB_ERR, wenn die Suche nicht erfolgreich war.
Bemerkungen
Diese Funktion ist nur erfolgreich, wenn die angegebene Zeichenfolge und ein Listenfeldelement die gleiche Länge haben (mit Ausnahme von NULL am Ende der angegebenen Zeichenfolge) und genau die gleichen Zeichen haben.
Wenn das Listenfeld über das vom Besitzer gezeichnete Format, aber nicht über die LBS_HASSTRINGS-Formatvorlage verfügt, hängt die von LB_FINDSTRINGEXACT ausgeführte Aktion davon ab, ob die LBS_SORT-Formatvorlage verwendet wird. Wenn LBS_SORT verwendet wird, sendet das System WM_COMPAREITEM Nachrichten an den Listenfeldbesitzer, um zu bestimmen, welches Element mit der angegebenen Zeichenfolge übereinstimmt. Andernfalls versucht LB_FINDSTRINGEXACT , ein Element zu finden, das über einen long-Wert verfügt (der als lParam-Parameter der LB_ADDSTRING - oder LB_INSERTSTRING-Nachricht angegeben wird), der dem lParam-Parameter entspricht.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
Header |
|