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