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 das Ende des Listenfelds erreicht, wird die Suche vom anfang 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, wird die Gesamtgröße der Elemente in einem Listenfeld nur durch den verfügbaren Arbeitsspeicher begrenzt.

lParam

Ein Zeiger auf die NULL-endende Zeichenfolge, die die Zeichenfolge enthält, nach der gesucht werden soll. Die Suche ist unabhängig von Groß- und Kleinbuchstaben, 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.

Bemerkungen

Wenn das Listenfeld die vom Besitzer gezeichnete Formatvorlage, aber nicht die LBS_HASSTRINGS hat, hängt die von LB_FINDSTRING 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_FINDSTRING , ein Element zu finden, das über einen long-Wert verfügt (angegeben als lParam-Parameter der LB_ADDSTRING - oder LB_INSERTSTRING-Nachricht ), der mit dem lParam-Parameter übereinstimmt.

Anforderungen

Siehe auch

LB_FINDSTRINGEXACT