ListBox_SelectItemData Makro (windowsx.h)

Durchsucht ein Listenfeld 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 LB_SELECTSTRING Nachricht explizit senden.

Syntax

int ListBox_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 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.

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

Bemerkungen

Weitere Informationen finden Sie unter LB_SELECTSTRING.

Anforderungen