ListBox_InsertItemData Makro (windowsx.h)

Artikel
10/24/2024

Fügt Elementdaten an der angegebenen Position in ein Listenfeld ein. Sie können dieses Makro verwenden oder die LB_INSERTSTRING Nachricht explizit senden.

Syntax

int ListBox_InsertItemData(
   HWND   hwndCtl,
   int    index,
   LPARAM data
);

Parameter

hwndCtl

Typ: HWND-

Ein Handle für das Steuerelement.

index

Typ: int

Der nullbasierte Index in der Liste, in der die Elementdaten eingefügt werden sollen, oder –1, um ihn am Ende der Liste hinzuzufügen.

data

Typ: LPARAM-

Ein Zeiger auf die einzufügenden Elementdaten.

Rückgabewert

Typ: int

Der Rückgabewert ist der nullbasierte Index des Elements im Listenfeld. Wenn ein Fehler auftritt, wird der Rückgabewert LB_ERR. Wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolge vorhanden ist, wird der Rückgabewert LB_ERRSPACE.

Bemerkungen

Verwenden Sie dieses Makro für ein Listenfeld mit einer vom Besitzer gezeichneten Formatvorlage, jedoch ohne die LBS_HASSTRINGS Formatvorlage. Weitere Informationen finden Sie unter LB_INSERTSTRING.

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