LB _ FINDSTRING-Nachricht
Sucht die erste Zeichenfolge in einem Listenfeld, das mit der angegebenen Zeichenfolge beginnt.
Parameter
-
wParam
-
Der nullbasierte Index des Elements vor dem ersten zu durchsuchenden Element. Wenn die Suche den unteren Rand 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 Edition (Windows Me): Der wParam-Parameter ist auf 16-Bit-Werte beschränkt. Das 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 in Byte nur durch den verfügbaren Arbeitsspeicher beschränkt.
-
lParam
-
Ein Zeiger auf die auf NULL endende Zeichenfolge, die die Zeichenfolge enthält, nach der gesucht werden soll. Die Suche ist unabhängig von Groß-/Kleinschreibung, sodass diese Zeichenfolge eine beliebige Kombination aus Groß- und Kleinbuchstaben enthalten kann.
Rückgabewert
Der Rückgabewert ist der Index des übereinstimmenden Elements oder LB _ ERR, wenn die Suche nicht erfolgreich war.
Hinweise
Wenn das Listenfeld den vom Besitzer gezeichneten Stil, aber nicht den LBS _ HASSTRINGS-Stil aufwies, hängt die von LB _ FINDSTRING ausgeführte Aktion davon ab, ob der LBS _ SORT-Stil verwendet wird. Wenn LBS _ SORT verwendet wird, sendet das System WM _ COMPAREITEM-Nachrichten an den Besitzer des Listenfelds, um zu bestimmen, welches Element mit der angegebenen Zeichenfolge übereinstimmt. Andernfalls versucht LB _ FINDSTRING, ein Element zu finden, das über einen long-Wert verfügt (bereitgestellt als lParam-Parameter der LB _ ADDSTRING- oder LB _ INSERTSTRING-Nachricht), der mit dem lParam-Parameter übereinstimmt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|