LB_SELECTSTRING

Eine Anwendung sendet eine LB_SELECTSTRING-Nachricht um ein Listenfeld für ein Element zu suchen, die mit dem Zeichen in einer angegebenen Zeichenfolge beginnt. Wenn ein übereinstimmendes Element gefunden wird, wird das Element ausgewählt.

LB_SELECTSTRING wParam = (WPARAM) IndexStart;        / / item vor Beginn der Suche lParam = (LPARAM) (LPCTSTR) LpszFind;  / / Adresse der Suchzeichenfolge 

 

Parameter

indexStart

Der wParam-Wert. Gibt den nullbasierten Index des Elements vor dem ersten Element durchsucht werden soll. Erreicht die Suche unten im Listenfeld, weiterhin es von der Spitze des Listenfelds zurück vom IndexStart -Parameter angegebenen Elements. Wenn IndexStart -1 ist, wird das gesamte Feld von Anfang an gesucht.

Windows 95 und Windows 98: Der wParam -Parameter beschränkt sich auf 16-Bit-Werte. Dies bedeutet, dass die Listenfelder können nicht mehr als 32.767 Elemente enthalten. Obwohl die Anzahl der Elemente eingeschränkt ist, ist die Gesamtgröße in Bytes der Elemente in einem Listenfeld nur durch den verfügbaren Arbeitsspeicher begrenzt.

lpszFind

Wert des lParam. Zeiger auf die Null-terminierte Zeichenfolge, die das Präfix für die Suche enthält. Die Suche gilt unabhängig, so dass diese Zeichenfolge eine Kombination aus Groß- und Kleinbuchstaben enthalten kann.

Rückgabewerte

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

Bemerkungen

Im Listenfeld wird, falls erforderlich, um das ausgewählte Element in Ansicht bringen gescrollt.

Verwenden Sie nicht diese Meldung mit einem Listenfeld, das den LBS_MULTIPLESEL Stil hat.

Nur, wenn die ersten Zeichen vom Startpunkt die Zeichen in der Zeichenfolge durch den LpszFind -Parameter angegebenen übereinstimmen, wird ein Element ausgewählt.

Wenn Sie im Listenfeld mit einem Ownerdrawn-Stil erstellen, aber ohne die LBS_HASSTRINGS Stil, diese Nachricht dem Index des Elements dessen long-Wert gibt (angegeben als Parameter lParam der Nachricht LB_ADDSTRING oder LB_INSERTSTRING) entspricht dem Wert als den lParam -Parameter der LB_SELECTSTRING.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.

Siehe auch

Liste Übersicht über Dialogfelder, Liste im Feld Nachrichten, LB_ADDSTRING, LB_FINDSTRING, LB_INSERTSTRING

Index