ListBox_SelectString Makro (windowsx.h)

Artikel
10/24/2024

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. Sie können dieses Makro verwenden oder die LB_SELECTSTRING Nachricht explizit senden.

Syntax

int ListBox_SelectString(
   HWND    hwndCtl,
   int     indexStart,
   LPCTSTR lpszFind
);

Parameter

hwndCtl

Typ: HWND-

Ein Handle für das Steuerelement.

indexStart

Typ: int

Der nullbasierte Index des Elements, bevor das erste Element durchsucht werden soll. Wenn die Suche das Ende des Listenfelds erreicht, wird die Suche vom anfang des Listenfelds wieder zurück zum Element gesucht, das durch den parameter indexStart angegeben wurde. Wenn indexStart- -1 ist, wird das gesamte Listenfeld von Anfang an durchsucht.

lpszFind

Typ: LPCTSTR-

Die zu suchende Zeichenfolge.

Rückgabewert

Typ: int

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

Weitere Informationen finden Sie unter LB_SELECTSTRING.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	windowsx.h

Freigeben über