CB_ADDSTRING Nachricht

Fügt dem Listenfeld eines Kombinationsfelds eine Zeichenfolge hinzu. Wenn das Kombinationsfeld nicht über das CBS_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.

Parameter

wParam

Dieser Parameter wird nicht verwendet.

lParam

Ein LPCTSTR-Zeiger auf die hinzuzufügende NULL-Zeichenfolge. Wenn Sie das Kombinationsfeld mit einer vom Besitzer gezeichneten Formatvorlage erstellen, aber ohne die CBS_HASSTRINGS Formatvorlage, wird der Wert des lParam-Parameters als Elementdaten und nicht als Zeichenfolge gespeichert, auf die er andernfalls verweist. Die Elementdaten können abgerufen oder geändert werden, indem Sie die CB_GETITEMDATA oder CB_SETITEMDATA Nachricht senden.

Rückgabewert

Der Rückgabewert ist der nullbasierte Index der Zeichenfolge im Listenfeld des Kombinationsfelds. Wenn ein Fehler auftritt, wird der Rückgabewert CB_ERR. Wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolge verfügbar ist, wird sie CB_ERRSPACE.

Bemerkungen

Wenn Sie ein vom Besitzer gezeichnetes Kombinationsfeld mit dem CBS_SORT Format erstellen, aber ohne die CBS_HASSTRINGS-Formatvorlage , wird die WM_COMPAREITEM Nachricht mehrmals an den Besitzer des Kombinationsfelds gesendet, sodass das neue Element ordnungsgemäß in der Liste platziert werden kann.

Um eine Zeichenfolge an einer bestimmten Stelle in der Liste einzufügen, verwenden Sie die CB_INSERTSTRING Nachricht.

Wenn das Kombinationsfeld WS_HSCROLL Stil aufweist und Sie eine Zeichenfolge breiter als das Kombinationsfeld hinzufügen, senden Sie eine LB_SETHORIZONTALEXTENT Nachricht, um sicherzustellen, dass die horizontale Bildlaufleiste angezeigt wird.

Comclt32.dll Version 5.0 oder höher: Wenn CBS_LOWERCASE oder CBS_UPPERCASE festgelegt ist, ändert die Unicode-Version von CB_ADDSTRING die Zeichenfolge. Bei Verwendung des schreibgeschützten globalen Arbeitsspeichers führt dies dazu, dass die Anwendung fehlschlägt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Winuser.h (einschließlich Windows.h)

Siehe auch

Referenz

CB_DIR

CB_INSERTSTRING

LB_SETHORIZONTALEXTENT

WM_COMPAREITEM