Freigeben über


ListBox_AddString Makro (windowsx.h)

Fügt einem Listenfeld eine Zeichenfolge hinzu. Wenn das Listenfeld nicht über das LBS_SORT-Format verfügt, wird die Zeichenfolge am Ende der Liste hinzugefügt. Andernfalls wird die Zeichenfolge in die Liste eingefügt, und die Liste wird sortiert. Sie können dieses Makro verwenden oder die LB_ADDSTRING Nachricht explizit senden.

Syntax

int ListBox_AddString(
   HWND   hwndCtl,
   LPCSTR lpsz
);

Parameter

hwndCtl

Typ: HWND-

Ein Handle für das Steuerelement.

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_ADDSTRING.

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