CB _ ADDSTRING-Nachricht

Fügt dem Listenfeld eines Kombinationsfelds eine Zeichenfolge hinzu. Wenn das Kombinationsfeld nicht über den CBS _ SORT-Stil 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 auf NULL endende Zeichenfolge, die hinzugefügt werden soll. Wenn Sie das Kombinationsfeld mit einem vom Besitzer gezeichneten Stil erstellen, jedoch ohne den CBS _ HASSTRINGS-Stil, wird der Wert des lParam-Parameters als Elementdaten anstelle der Zeichenfolge gespeichert, auf die er andernfalls verweisen würde. Die Elementdaten können durch Senden der CB _ GETITEMDATA- oder CB _ SETITEMDATA-Nachricht abgerufen oder geändert werden.

Rückgabewert

Der Rückgabewert ist der nullbasierte Index für die Zeichenfolge im Listenfeld des Kombinationsfelds. Wenn ein Fehler auftritt, lautet der Rückgabewert CB _ ERR. Wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolge verfügbar ist, handelt es sich um CB _ ERRSPACE.

Bemerkungen

Wenn Sie ein vom Besitzer gezeichnetes Kombinationsfeld mit dem CBS-SORT-Stil _ erstellen, jedoch ohne den CBS _ HASSTRINGS-Stil, wird die WM _ COMPAREITEM-Nachricht ein oder mehrere Male an den Besitzer des Kombinationsfelds gesendet, damit das neue Element ordnungsgemäß in der Liste platziert werden kann.

Verwenden Sie die CB _ INSERTSTRING-Nachricht, um eine Zeichenfolge an einer bestimmten Position in der Liste einzufügen.

Wenn das Kombinationsfeld den WS _ HSCROLL-Stil auf hat und Sie eine Zeichenfolge hinzufügen, die breiter als das Kombinationsfeld ist, senden Sie eine LB _ SETHORIZONTALEXTENT-Nachricht, um sicherzustellen, dass die horizontale Scrollleiste 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. Wenn Sie schreibgeschützten globalen Speicher verwenden, führt dies dazu, dass die Anwendung fehlschlägt.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Winuser.h (include Windows.h)

Weitere Informationen

Referenz

CB _ DIR

CB _ INSERTSTRING

LB _ SETHORIZONTALEXTENT

WM _ COMPAREITEM