LB_INSERTSTRING訊息
將字串或專案資料插入清單方塊中。 不同于 LB_ADDSTRING 訊息， LB_INSERTSTRING 訊息不會讓具有 LBS_SORT 樣式的清單排序。
參數
-
wParam
-
要插入字串的位置之以零起始的索引。 如果此參數為 -1，字串就會新增至清單的結尾。
-
lParam
-
要插入之 Null 終止字串的指標。 如果清單方塊有擁有者繪製的樣式，但不是 LBS_HASSTRINGS 樣式，此參數會儲存為專案資料，而不是字串。 您可以傳送 LB_GETITEMDATA 和 LB_SETITEMDATA 訊息，以擷取或修改專案資料。
傳回值
傳回值是插入字串的位置索引。 如果發生錯誤，傳回值會LB_ERR。 如果空間不足而無法儲存新字串，則傳回值會LB_ERRSPACE。
備註
LB_INITSTORAGE訊息有助於加速清單方塊的初始化，這些清單方塊 (超過 100 個) 。 它會保留指定的記憶體數量，讓後續 LB_INSERTSTRING 訊息需要最短的時間。 您可以使用 wParam 和 lParam 參數的估計值。 如果您超額，則會配置額外的記憶體;如果您忽略，則一般配置會用於超過要求金額的專案。
如果清單方塊具有 WS_HSCROLL 樣式，而且您插入比清單方塊寬的字串，請傳送 LB_SETHORIZONTALEXTENT 訊息，以確保水準捲軸出現。
針對 ANSI 應用程式，系統會使用 CP_ACP，將清單方塊中的文字轉換成 Unicode。 這可能會導致問題。 例如，日文 Windows 中非 Unicode 清單方塊中的輔色羅馬字元將會變大。 若要修正此問題，請將應用程式編譯為 Unicode，或使用擁有者繪製的清單方塊。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
| 標頭 |
|