LB_SELECTSTRING訊息
搜尋清單方塊中以指定字串中的字元開頭的專案。 如果找到相符的專案,則會選取專案。
參數
-
wParam
-
搜尋第一個項目之前,項目以零為起始的索引。 當搜尋到達清單方塊底部時,它會從清單方塊的頂端繼續回到 wParam 參數所指定的專案。 如果 wParam 為 -1,則會從頭搜尋整個清單方塊。
Windows 95/Windows 98/Windows Premium Edition (Windows Me) : wParam 參數限制為 16 位值。 這表示清單方塊不能包含超過 32,767 個專案。 雖然專案數目受到限制,但清單方塊中專案的總大小以位元組為單位只會受限於可用的記憶體。
-
lParam
-
Null 終止字串的指標,其中包含要搜尋的前置詞。 搜尋與大小寫無關,因此此字串可以包含大寫和小寫字母的任何組合。
傳回值
如果搜尋成功,則傳回值是所選項目的索引。 如果搜尋失敗,傳回值會LB_ERR且目前的選取範圍不會變更。
備註
如有必要,清單方塊會捲動,以將選取的專案帶入檢視中。
請勿將此訊息與具有 LBS_MULTIPLESEL 或 LBS_EXTENDEDSEL 樣式的清單方塊搭配使用。
只有當專案從起點的初始字元符合 lParam 參數所指定的字串中的字元時,才會選取專案。
如果清單方塊具有擁有者繪製的樣式,但不是 LBS_HASSTRINGS 樣式, 則LB_SELECTSTRING 所採取的動作取決於是否使用 LBS_SORT 樣式。 如果使用 LBS_SORT ,系統會 將WM_COMPAREITEM 訊息傳送至清單方塊擁有者,以判斷哪個專案符合指定的字串。 否則,LB_SELECTSTRING會嘗試尋找具有長值的專案, (做為LB_ADDSTRING的lParam參數提供,或LB_INSERTSTRING訊息) 符合lParam參數。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
標頭 |
|