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	Winuser.h (einschließlich Windows.h)

Siehe auch

Referenz

CB_FINDSTRINGEXACT

CB_SELECTSTRING

CB_SETCURSEL

WM_COMPAREITEM