Share via

LB_FINDSTRING訊息

  • 發行項

在以指定字串開頭的清單方塊中尋找第一個字串。

參數

wParam

搜尋第一個項目之前，項目以零為起始的索引。 當搜尋到達清單方塊底部時，它會繼續從清單方塊頂端搜尋回到 wParam 參數所指定的專案。 如果 wParam 為 -1，則會從頭搜尋整個清單方塊。

Windows 95/Windows 98/Windows Premium Edition (Windows Me) ： wParam 參數限制為 16 位值。 這表示清單方塊不能包含超過 32，767 個專案。 雖然專案數目受到限制，但清單方塊中專案的總大小以位元組為單位只會受限於可用的記憶體。

lParam

包含要搜尋之字串之 Null 終止字串的指標。 搜尋與大小寫無關，因此此字串可以包含大寫和小寫字母的任何組合。

傳回值

傳回值是相符專案的索引，如果搜尋失敗，則LB_ERR。

備註

如果清單方塊具有擁有者繪製的樣式，但不是 LBS_HASSTRINGS 樣式， 則LB_FINDSTRING 所採取的動作取決於是否使用 LBS_SORT 樣式。 如果使用 LBS_SORT ，系統會 將WM_COMPAREITEM 訊息傳送至清單方塊擁有者，以判斷哪個專案符合指定的字串。 否則，LB_FINDSTRING嘗試尋找 (做為LB_ADDSTRING之lParam參數提供之 long 值的專案，或LB_INSERTSTRING訊息) 符合lParam參數的專案。

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2003 [僅限傳統型應用程式]
標頭
Winuser.h (包含 Windows.h)

另請參閱

LB_FINDSTRINGEXACT