Freigeben über


ListBox_InsertString Makro (windowsx.h)

Fügt an der angegebenen Position eine Zeichenfolge zu einem Listenfeld hinzu. Sie können dieses Makro verwenden oder die LB_INSERTSTRING Nachricht explizit senden.

Syntax

int ListBox_InsertString(
   HWND   hwndCtl,
   int    index,
   LPCSTR lpsz
);

Parameter

hwndCtl

Typ: HWND-

Ein Handle für das Steuerelement.

index

Typ: int

Der nullbasierte Index, an dem die Zeichenfolge eingefügt werden soll, oder –1, um sie am Ende der Liste hinzuzufügen.

lpsz

Typ: LPCSTR-

Die hinzuzufügende Zeichenfolge.

Rückgabewert

Typ: int

Der Rückgabewert ist der nullbasierte Index der Zeichenfolge 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

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