ComboBox_SelectItemData Makro (windowsx.h)

Artikel
10/24/2024

Durchsucht eine Liste in einem Kombinationsfeld nach einem Element, das die angegebenen Elementdaten enthält. Wenn ein übereinstimmende Element gefunden wird, wird das Element ausgewählt. Sie können dieses Makro verwenden oder die CB_SELECTSTRING Nachricht explizit senden.

Syntax

int ComboBox_SelectItemData(
   HWND   hwndCtl,
   int    indexStart,
   LPARAM data
);

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 der Liste erreicht, wird die Suche vom Anfang der Liste zurück zum element, das durch den indexStart Parameter angegeben wird, fortgesetzt. Wenn indexStart- -1 ist, wird die gesamte Liste von Anfang an durchsucht.

data

Typ: LPARAM-

Die zu suchenden Elementdaten.

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 CB_ERR und die aktuelle Auswahl wird nicht geändert.

Bemerkungen

Weitere Informationen finden Sie unter CB_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