CB_SELECTSTRING Nachricht

  • Artikel

Durchsucht die Liste eines Kombinationsfelds nach einem Element, das mit den Zeichen in einer angegebenen Zeichenfolge beginnt. Wenn ein übereinstimmende Element gefunden wird, wird es ausgewählt und in das Bearbeitungssteuerelement kopiert.

Parameter

wParam

Der nullbasierte Index des Elements vor dem ersten zu durchsuchenden Element. Wenn die Suche das Ende der Liste erreicht, wird sie vom Anfang der Liste zurück zu dem durch den wParam-Parameter angegebenen Element fortgesetzt. Wenn wParam -1 ist, wird die gesamte Liste von Anfang an durchsucht.

lParam

Ein Zeiger auf die NULL-endende 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

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

Bemerkungen

Eine Zeichenfolge wird nur ausgewählt, wenn die Zeichen vom Ausgangspunkt mit den Zeichen in der Präfixzeichenfolge übereinstimmen.

Wenn Sie das Kombinationsfeld mit einer vom Besitzer gezeichneten Formatvorlage erstellen, aber ohne die CBS_HASSTRINGS-Formatvorlage , hängt die CB_SELECTSTRING meldung davon ab, ob Sie die CBS_SORT Formatvorlage verwenden. Wenn die CBS_SORT Stil verwendet wird, sendet das System WM_COMPAREITEM Nachrichten an den Besitzer des Kombinationsfelds, um zu bestimmen, welches Element mit der angegebenen Zeichenfolge übereinstimmt. Wenn Sie nicht die CBS_SORT-Formatvorlage verwenden, versucht CB_SELECTSTRING , den DWORD-Wert mit dem Wert des lParam-Parameters abzugleichen.

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)

Siehe auch

Referenz

CB_FINDSTRING

CB_FINDSTRINGEXACT

CB_SETCURSEL

WM_COMPAREITEM