Freigeben über


LB_SELECTSTRING Nachricht

Durchsucht ein Listenfeld nach einem Element, das mit den Zeichen in einer angegebenen Zeichenfolge beginnt. Wenn ein übereinstimmende Element gefunden wird, wird das Element ausgewählt.

Parameter

wParam

Der nullbasierte Index des Elements vor dem ersten zu durchsuchenden Element. Wenn die Suche das Ende des Listenfelds erreicht, wird sie 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, wird die Gesamtgröße der Elemente in einem Listenfeld nur durch den verfügbaren Arbeitsspeicher begrenzt.

lParam

Ein Zeiger auf die NULL-Zeichenfolge, die das Präfix enthält, nach dem 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

Wenn die Suche erfolgreich ist, ist der Rückgabewert der Index des ausgewählten Elements. Wenn die Suche nicht erfolgreich ist, wird der Rückgabewert LB_ERR, und die aktuelle Auswahl wird nicht geändert.

Bemerkungen

Das Listenfeld wird bei Bedarf gescrollt, um das ausgewählte Element in die Ansicht zu bringen.

Verwenden Sie diese Meldung nicht mit einem Listenfeld, das die formatvorlagen LBS_MULTIPLESEL oder LBS_EXTENDEDSEL enthält.

Ein Element wird nur ausgewählt, wenn seine Anfangszeichen vom Anfangspunkt mit den Zeichen in der Zeichenfolge übereinstimmen, die vom lParam-Parameter angegeben werden.

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

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)

Weitere Informationen

Referenz

LB_ADDSTRING

LB_FINDSTRING

LB_INSERTSTRING