LB _ INSERTSTRING-Nachricht
Fügt eine Zeichenfolge oder Elementdaten in ein Listenfeld ein. Im Gegensatz zur LB _ ADDSTRING-Nachricht führt die LB _ INSERTSTRING-Nachricht nicht dazu, dass eine Liste mit dem _ LBS-SORT-Stil sortiert wird.
Parameter
-
wParam
-
Der nullbasierte Index der Position, an der die Zeichenfolge eingefügt werden soll. Wenn dieser Parameter -1 ist, wird die Zeichenfolge am Ende der Liste hinzugefügt.
-
lParam
-
Ein Zeiger auf die auf NULL endende Zeichenfolge, die eingefügt werden soll. Wenn das Listenfeld einen vom Besitzer gezeichneten Stil hat, aber nicht den LBS _ HASSTRINGS-Stil, wird dieser Parameter als Elementdaten anstelle einer Zeichenfolge gespeichert. Sie können die LB _ GETITEMDATA- und LB _ SETITEMDATA-Nachrichten senden, um die Elementdaten abzurufen oder zu ändern.
Rückgabewert
Der Rückgabewert ist der Index der Position, an der die Zeichenfolge eingefügt wurde. Wenn ein Fehler auftritt, lautet der Rückgabewert LB _ ERR. Wenn nicht genügend Speicherplatz zum Speichern der neuen Zeichenfolge vorhanden ist, lautet der Rückgabewert LB _ ERRSPACE.
Hinweise
Die LB _ INITSTORAGE-Nachricht beschleunigt die Initialisierung von Listenfeldern mit einer großen Anzahl von Elementen (mehr als 100). Die angegebene Arbeitsspeichermenge wird reserviert, sodass nachfolgende LB _ INSERTSTRING-Nachrichten die kürzeste Zeit in Anspruch nehmen. Sie können Schätzungen für die Parameter wParam und lParam verwenden. Wenn Sie überbewerten, wird der zusätzliche Arbeitsspeicher belegt. Wenn Sie dies nicht möchten, wird die normale Zuordnung für Elemente verwendet, die den angeforderten Betrag überschreiten.
Wenn das Listenfeld den WS _ HSCROLL-Stil auf hat und Sie eine Zeichenfolge einfügen, die breiter als das Listenfeld ist, senden Sie eine LB _ SETHORIZONTALEXTENT-Nachricht, um sicherzustellen, dass die horizontale Scrollleiste angezeigt wird.
Bei einer ANSI-Anwendung konvertiert das System den Text in einem Listenfeld mit CP ACP in _ Unicode. Dies kann Probleme verursachen. Beispielsweise werden romanische Zeichen mit Akzent in einem Nicht-Unicode-Listenfeld in japanischen Windows verschachtelt angezeigt. Kompilieren Sie die Anwendung entweder als Unicode, oder verwenden Sie ein vom Besitzer gezeichnetes Listenfeld, um dieses Problem zu beheben.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|