CB_FINDSTRING Nachricht
Durchsucht das Listenfeld eines Kombinationsfelds nach einem Element, das mit den Zeichen in einer angegebenen Zeichenfolge beginnt.
Parameter
-
wParam
-
Der nullbasierte Index des Elements vor dem ersten zu durchsuchenden Element. Wenn die Suche das ende des Listenfelds erreicht, fährt sie vom oberen Rand des Listenfelds zurück zu dem durch den wParam-Parameter angegebenen Element. Wenn wParam -1 ist, wird das gesamte Listenfeld von Anfang an durchsucht.
-
lParam
-
Ein Zeiger auf die NULL-Zeichenfolge, die die Zeichen enthält, nach denen 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. Wenn die Suche nicht erfolgreich ist, wird sie CB_ERR.
Bemerkungen
Wenn Sie das Kombinationsfeld mit einer vom Besitzer gezeichneten Formatvorlage erstellen, aber ohne die CBS_HASSTRINGS-Formatvorlage, hängt die CB_FINDSTRING-Nachricht davon ab, ob Ihre Anwendung die CBS_SORT-Formatvorlage verwendet. Wenn Sie die CBS_SORT-Format verwenden, werden WM_COMPAREITEM Nachrichten an den Besitzer des Kombinationsfelds gesendet, um zu bestimmen, welches Element mit der angegebenen Zeichenfolge übereinstimmt. Wenn Sie nicht die CBS_SORT Formatvorlage verwenden, sucht die CB_FINDSTRING-Nachricht nach einem Listenelement, das dem Wert des lParam-Parameters entspricht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Header |
|