CB_SELECTSTRING訊息
在下拉式方塊清單中搜尋以指定字串字元開頭的專案。 如果找到相符的專案,則會選取並複製到編輯控制項。
參數
-
wParam
-
要搜尋之第一個專案前面的專案之以零起始的索引。 當搜尋到達清單底部時,它會從清單頂端繼續回到 wParam 參數所指定的專案。 如果 wParam 為 -1,則會從頭搜尋整個清單。
-
lParam
-
Null 終止字串的指標,其中包含要搜尋的字元。 搜尋不區分大小寫,因此此字串可以包含大寫和小寫字母的任何組合。
傳回值
如果找到字串,傳回值會是所選項目的索引。 如果搜尋失敗,傳回值會CB_ERR,而且目前的選取範圍不會變更。
備註
只有在起點的字元符合前置詞字串中的字元時,才會選取字串。
如果您使用擁有者繪製樣式來建立下拉式方塊,但沒有 CBS_HASSTRINGS 樣式, 則CB_SELECTSTRING 訊息的功能取決於您是否使用 CBS_SORT 樣式。 如果使用 CBS_SORT 樣式,系統會傳送 WM_COMPAREITEM 訊息給下拉式方塊的擁有者,以判斷哪一個專案符合指定的字串。 如果您沒有使用 CBS_SORT 樣式, CB_SELECTSTRING 會嘗試比對 DWORD 值與 lParam 參數的值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
標頭 |
|