CB_ADDSTRING訊息
將字串新增至下拉式方塊的清單方塊。 如果下拉式方塊沒有 CBS_SORT 樣式,則會將字串新增至清單的結尾。 否則,字串會插入清單中,並排序清單。
參數
-
wParam
-
不使用這個參數。
-
lParam
-
要加入之 Null 終止字串的 LPCTSTR 指標。 如果您使用擁有者繪製樣式來建立下拉式方塊,但沒有 CBS_HASSTRINGS 樣式, lParam 參數的值會儲存為專案資料,而不是它所指向的字串。 您可以藉由傳送 CB_GETITEMDATA 或 CB_SETITEMDATA 訊息來擷取或修改專案資料。
傳回值
傳回值是下拉式方塊清單方塊中字串的以零起始的索引。 如果發生錯誤,則會CB_ERR傳回值。 如果空間不足而無法儲存新的字串,則會CB_ERRSPACE。
備註
如果您使用 CBS_SORT 樣式來建立擁有者繪製的下拉式方塊,但沒有 CBS_HASSTRINGS 樣式, 則會將WM_COMPAREITEM 訊息傳送至下拉式方塊的擁有者,讓新專案可以正確放置在清單中。
若要在清單中的特定位置插入字串,請使用 CB_INSERTSTRING 訊息。
如果下拉式方塊具有 WS_HSCROLL 樣式,而且您新增比下拉式方塊寬的字串,請傳送 LB_SETHORIZONTALEXTENT 訊息,以確保水準捲軸出現。
Comclt32.dll 5.0 版或更新版本: 如果 已設定CBS_LOWERCASE 或 CBS_UPPERCASE , CB_ADDSTRING 的 Unicode 版本會改變字串。 如果使用唯讀全域記憶體,這會導致應用程式失敗。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
標頭 |
|