基于MSDN的ListBoxD 處理消息
(1)、LB_FINDSTRING 消息(一般查找)
wParam 在第一個條目被查找到之前的條目索引(也就是開始查找的索引位置)。當搜索達到列表框的底部時,搜索將重新回到由該參數指定的位置從頭查找。如果該參數為-1,將從列表框的起始索引(0)開始查找。
lParam 一個指向以NULL結尾的字符串,該字符串包含了將要搜索的內容。搜索是大小寫敏感的。所以可以搜索任何大小寫組合的字符串形式。
Return Value 如果成功,返回第一個匹配的條目的索引,如果失敗,返回LB_ERR。
備注::如果你以自繪形式創建的列表框,該消息會返回一個匹配由lParam參數提供的值長整型的值。
(2)、LB_FINDSTRINGEXACT 消息(精確查找)
wParam 基于零的開始索引。當搜索達到列表框的底部時,將返回到開始索引處繼續進行搜索。如果該參數為-1,將從列表框的開始處從頭執行搜索。
lParam 指向被搜索字串的字符串指針。該字符串可以包含完整的文件名及擴展。搜索是不分大小寫的。
Return Value 返回值是基于零的匹配條目的索引。當失敗時,返回LB_ERR。
Remarks 該函數僅在指定字符串和列表框中的條目的長度相等且每個字符均相等的情況才算匹配。如果一個應用程序以自繪樣式創建列表框,則由該消息執行的內容將取決于LBS_SORT是否被使用。
(3)、LB_GETANCHORINDEX 消息 //獲得條目錨點的索引,錨點就是多選狀態下選擇的起始條目。
(4)、LB_GETCARETINDEX 消息 //返回在多選狀態下,具有焦點的條目的索引。該條目既可以被選中,也可以是沒被選中。
(5)、LB_GETCURSEL 消息 //獲得當前被選條目的索引。僅在單選狀態的列表框有效。
Return Value 在單選狀態的列表框中,返回值是基于零的當前選中條目的索引,如果未發現選中的條目,返回值是LB_ERR。
Remarks 不要給多選狀態的列表框發送該消息。為了獲得處于多選狀態的列表框的選中條目的索引,可以使用LB_GETSELITEMS消息。如果要獲得多選狀態下的列表框中哪一個條目具有焦點,可以使用LB_GETSEL消息。如果將該消息發送給一個具有多選狀態的列表框,該消息返回具有焦點的條目索引。如果沒有條目被選中,返回 0.
(6)、LB_GETHORIZONTALEXTENT 消息 //如果列表框具有一個水平滾動條,該消息獲得水平滾動的寬度(單位像素)
Return Value 返回值是滾動寬度(單位是像素)
Remarks 為了響應該消息列表框必須已經定義了WS_HSCROLL樣式。如果應用程序并未給列表框定義水平擴展(使用LB_SETHORIZONTALEXTENT),默認的水平擴展時0.注意:列表框并不會自動更新水平擴展。
(7)、LB_GETITEMDATA 消息 //獲得與指定的列表框中條目相關的程序自定義值。
(8)、LB_GETITEMHEIGHT //應用程序發送該消息用以返回一個Listbox中條目的高度
wParam 指定基于0的listbox 中的條目。該索引僅在列表框使用 LBS_OWNERDRAWVARIABLE風格時使用。否則,該值必須為0.
(9)、LB_GETITEMRECT //獲得列表框中條目的邊界矩形尺寸
wParam 條目的索引值。
lParam 指向一個RECT結構的指針,該結構用于接收列表框中條目的客戶坐標值
(10)、LB_GETLOCALE //獲得當前列表框的區域??梢允褂眠@個區域來決定顯示文本正確的排序規則。
(11)、LB_GETSEL Message //獲得一個條目的選擇狀態。如果一個條目被選中,返回Yu值大于0,否則,返回值是0.如果發生錯誤,返回LB_ERR.
(12)、LB_GETSELCOUNT Message //在具有多選狀態的列表框中,該消息獲得選中的條目的數量 。返回值是列表框中選中的條目的數量。如果列表框處于單選狀態,返回值是LB_ERR。
(13)、LB_GETSELITEMS Message //在具有多選狀態的列表框中,該消息通過填充一個緩沖來保存被選中的條目。
wParam 選中條目數量的最大值。
lParam 足夠大的緩沖用于存儲整型值。
Return Value 返回值是放置在緩沖中的條目的數量。如果列表框處于單選狀態,返回值是LB_ERR.
(14)、LB_GETTEXT //從列表框中獲得一個字符串。
wParam 所要返回的字符串。
lParam 接收字符串的緩沖器。它的類型是LPTSTR,之后將強化轉換為LPARAM。緩沖器必須具有足夠的空間開存儲字符串(包括結尾的NULL)。一個LB_GETTEXTLEN消息可以在應用該消息之前用來獲得字符串長度(單位是TCHARS)。
Return Value 返回值是字符串長度(TCHARS)。不包括結尾的NULL字符。如果wParam未指定一個有效的索引,返回值LB_ERR
Remarks 如果以自繪樣式創建一個列表框,緩沖器指針將接受與條目(條目數據)相關的值。
(15)、LB_GETTEXTLEN //獲得一個列表框中字符串的長度
wParam 字符串的索引。
lParam 未使用,必須為0
Return Value 返回值是字符串的長度,不包括結尾的NULL字符。在特定的情況下,該值事實上可能比文本的真實長度要大。如果wParam參數指向一個無效的索引,返回值是LB_ERR。
Remarks 在特定條件下,返回值將比真實的長度要大。這種情況發生在ANSI和Unicode混合時。
如果要獲得精確的長度,可以使用WM_GETTEXT,LB_GETTEXT 或 CB_GETLBTEXT消息,或 GetWindowText 函數。
(16)、LB_GETTOPINDEX Message //獲得第一個“可見”的條目的索引。初始化時,第一個可見的條目是索引為0的條目,但如果列表框的發生滾動之后,該索引值會發生變化。
返回值是第一個可見的條目的索引。
(17)、LB_INITSTORAGE Message //定位內存用于存儲列表框中的條目。該消息在向列表框中加入大量條目時使用。
wParam 加入的條目數量。
lParam 內存的量用于存儲條目字符串。(以字節)。
Return Value如果消息成功,返回值是所有的條目數量。如果消息失敗,返回值是LB_ERRSPACE。
Remarks 該消息能夠幫助加速條目數大于100的列表框初始化進程。它會預留一定量的內存空間,這樣,接下來LB_ADDSTRING,LB_INSERTSTRING,LB_DIR 和 LB_ADDFILE消息會使用更少的時間。
(18)、LB_INSERTSTRING Message //向列表框中插入一個條目數據或字符串。不像LB_ADDSTRING 消息,該消息不會激活LBS_SORT樣式來對條目進行排序。
wParam 插入字符串的位置。如果參數為-1,字符串將插入到列表框的尾部。
lParam 所要插入的字符串指針。如果以自繪的形式創建列表框,該參數的值會作為條目數據本身而不是字符串指針來存儲。可以使用LB_GETITEMDATA 和LB_SETITEDATA 消息來接收或修改條目數據。
Return Value 返回值是插入處的索引。如果發生錯誤,返回值是LB_ERR。如果沒有足夠空間來存儲新的字符串,返回值LB_ERRSPACE。
(19)、LB_ITEMFROMPOINT //一個應用程序發送這個消息用以返回基于0的位于ListBox內的離指定的點位置最近一個條目
返回值中低位存儲的是最近條目,高位存儲的值取決于給定點的位置,如果該點位于客戶區內,則為0,否則為1
(20)、LB_SELITEMRANGE //在多選狀態下的列表框中選擇或取消選擇一個或多個連續條目。
wParam TRUE 代表選擇條目,FALSE為取消選擇。
lParam 低位字指定第一個選擇的條目索引。高位字指定最后一個選擇的條目索引。
Return Value如果發生錯誤,返回LB_ERR。
Remarks僅在具有多選狀態的列表框中使用該消息。該消息僅能用于前65536個條目。
(21)、LB_SELITEMRANGEEX //在多選狀態下的列表框中選擇一個或多個連續的條目。
wParam 指定選中條目中第一個條目的索引。
lParam 指定選中條目中最后一個條目的索引
(22)、LB_SETANCHORINDEX // 設置錨點條目——從該條目開始,一個多重選擇開始。一個多重選擇會跨越錨點條目和結尾條目間所有的條目
wParam 新錨點條目的索引。
lParam 該參數未使用。
Return Value 如果消息成功,返回值是0,如果消息失敗,返回值是LB_ERR。
(23)、LB_SETCARETINDEX //在位于多選狀態下的列表框中指定索引下設置焦點矩形。如果條目不可見,會自動滾動可見。
(24)、LB_SETCOLUMNWIDTH Message //對多列的列表框設置所有列的寬度(單位是像素)
wParam 所有列的寬度(像素)
lParam 未使用,可以為0
Return Value 無返回值
(25)、LB_SETCOUNT Message //設置由LBS_NODATA樣式而不是LBS_HASSTRINGS樣式創建的列表框的條目數量。
wParam 指定列表框中的條目數量。
lParam 未使用。
Return Value如果發生錯誤,返回值是LB_ERR。如果沒有足夠的內存空間,返回LB_ERRSPACE。
(26)、LB_SETCURSEL Message //選擇一個字符串,并將其所在的條目滾動到視野內。當新的字符串被選定,列表框的高亮顯示將從原有的選中字符串移動到這個新的字符串上。
wParam 指定字符串索引。如果該參數為-1,列表框不具有任何選中條目。
lParam 未使用,可以為0.
Return Value 如果發生錯誤,返回LB_ERR。如果wParam為-1,則無論什么情況均返回LB_ERR
Remarks 該消息僅適用于單選狀體下的列表框。
(27)、LB_SETHORIZONTALEXTENT // 該消息用來設置列表框的寬度(單位是像素)。如果列表框的寬度小于設置的值,顯示水平滾動條。如果列表框的寬度等于設置的值,則不顯示滾動條。
LB_SETHORIZONTALEXTENT wParam = (WPARAM) cxExtent;
// 水平滾動寬度 lParam = 0;
// 未使用,必須為0
(28)、LB_SETITEMHEIGHT //應用程序通過發送該消息來設置ListBox中條目的高度(單位是像素)。
wParam = (WPARAM) index; // 條目索引lParam = MAKELPARAM(cyItem, 0);
lParam // 條目高度
(29)、LB_SETLOCALE
設置列表框的當前區域??梢允褂脜^域來決定顯示文本的正確排序規則。
wParam 指定區域標識。該表示用于列表框添加文本時排序之用。
lParam 該參數未被使用。
Return Value 返回值是之前的區域標識符。如果wParam參數指定一個未在系統中安裝的區域,返回值是LB_ERR,且當前的列表框區域不會發生改變。
可以使用MAKELCID宏來構建一個區域標識符
(30)、LB_SETSEL //在多選狀態下的列表框中選擇一個字符串。
wParam 指定如何設置選擇。如果該參數為TRUE ,字符串被選中且高亮,如果為FALSE,移除高亮且字符串不再處于被選中狀態。
lParam 指定字符串的索引。如果該參數為-1,選擇的添加或刪除取決于wParam的值。
Return Value 如果有錯誤,返回LB_ERR。
Remarks僅在多選狀態的列表框使用該消息才有效。
(31)、LB_SETTABSTOPS //設置列表框的移字鍵。
wParam 移字鍵編號。
lParam 編號數組的第一個編號。
(32)、LB_SETTOPINDEX //確保給定條目在列表框中式可見的
wParam 條目索引
lParam 未被使用。
Return Value 如果發生錯誤,則返回LB_ERR.
Remarks 系統會滾動列表框以使指定的條目出現在列表框的頂部或達到最大滾動范圍
(33)、LB_SETITEMDATA Message // 設置與列表框中指定條目相關的值。
wParam 指定條目的索引。如果該值為-1,lParam值應用于所有的列表框中的條目
lParam 指定與條目相關的值。
Return Value 發生錯誤,返回LB_ERR.
Remarks 如果條目位于一個以自繪樣式創建的列表框中,該消息將替換LB_ADDSTRING 或 LB_INSERTSTRING 消息中lParam參數的值。
//////////////////////////////////////////