清單框
本節包含與清單框搭配使用之程式設計專案的相關信息。 清單框是控件視窗，其中包含用戶可從中選擇的簡單專案清單。 如需更複雜的清單，請改用 [列表檢視 ]。
概觀
| 主題 | 目錄 |
|---|---|
| 關於清單框 | 描述清單框功能。 |
| 使用清單框 | 說明如何執行與清單框相關聯的工作。 |
函式
| 主題 | 目錄 |
|---|---|
| DlgDirList | 以指定目錄中的子目錄和檔案名稱取代清單框的內容。 |
| DlgDirSelectEx | 從單一選取清單框擷取目前的選取範圍。 |
| DrawInsert | 在指定拖曳清單框的父視窗中繪製插入圖示。 |
| GetListBoxInfo | 擷取指定清單框的相關信息。 |
| LBItemFromPt | 擷取清單框中指定點的專案索引。 |
| MakeDragList | 將指定的單一選取清單框變更為拖曳清單框。 |
訊息
| 主題 | 目錄 |
|---|---|
| LB_ADDFILE | 將指定的檔案名新增至包含目錄清單的清單框。 |
| LB_ADDSTRING | 將字串新增至清單框。 |
| LB_DELETESTRING | 刪除清單框中的字串。 |
| LB_DIR | 將名稱新增至清單框所顯示的清單。 |
| LB_FINDSTRING | 尋找以指定字串開頭的清單框中的第一個字串。 |
| LB_FINDSTRINGEXACT | 尋找與指定字串完全相符的第一個清單框字串，但搜尋不區分大小寫。 |
| LB_GETANCHORINDEX | 取得錨點專案的索引，也就是從中開始多重選取的專案。 |
| LB_GETCARETINDEX | 擷取具有多重選取清單框中焦點矩形的專案索引。 專案可能或可能未選取。 |
| LB_GETCOUNT | 取得清單框中的項目數。 |
| LB_GETCURSEL | 取得目前選取之專案的索引，如果有的話，在單一選取清單框中。 |
| LB_GETHORIZONTALEXTENT | 取得寬度，以像素為單位，如果清單框具有水平滾動條，清單框可以水平捲動（可捲動的寬度）。 |
| LB_GETITEMDATA | 取得與指定清單框項目相關聯的應用程式定義值。 |
| LB_GETITEMHEIGHT | 取得清單框中專案的高度。 |
| LB_GETITEMRECT | 取得矩形的維度，此矩形會系結清單框專案，因為它目前顯示在清單框中。 |
| LB_GETLISTBOXINFO | 取得指定清單框中每個數據行的項目數。 |
| LB_GETLOCALE | 取得清單框的目前地區設定。 |
| LB_GETSEL | 取得項目的選取狀態。 |
| LB_GETSELCOUNT | 取得多重選取清單框中選取的項目總數。 |
| LB_GETSELITEMS | 以整數陣列填入緩衝區，以指定多重選取清單框中所選取專案的項目編號。 |
| LB_GETTEXT | 從清單框取得字串。 |
| LB_GETTEXTLEN | 取得清單框中字串的長度。 |
| LB_GETTOPINDEX | 取得清單框中第一個可見專案的索引。 |
| LB_INITSTORAGE | 配置記憶體來儲存清單框專案。 此訊息會在應用程式將大量專案新增至清單框之前使用。 |
| LB_INSERTSTRING | 將字串或項目資料插入清單框中。 不同於LB_ADDSTRING訊息，LB_INSERTSTRING訊息不會讓具有LBS_SORT樣式的清單排序。 |
| LB_ITEMFROMPOINT | 取得清單框中最接近指定點之專案之以零起始的索引。 |
| LB_RESETCONTENT | 從清單框中移除所有專案。 |
| LB_SELECTSTRING | 搜尋清單框中以指定字串中的字元開頭的專案。 |
| LB_SELITEMRANGE | 選取或取消選取多重選取清單框中的一或多個連續專案。 |
| LB_SELITEMRANGEEX | 在多重選取清單框中選取一或多個連續專案。 |
| LB_SETANCHORINDEX | 設定錨點專案，也就是從中開始多重選取的專案。 多重選取範圍橫跨錨點專案到插入號專案的所有專案。 |
| LB_SETCARETINDEX | 將焦點矩形設定為位於多重選取清單框中指定索引處的專案。 如果看不到專案，則會捲動到檢視中。 |
| LB_SETCOLUMNWIDTH | 設定多欄清單框中所有數據行的寬度，以像素為單位。 |
| LB_SETCOUNT | 設定以LBS_NODATA樣式建立的清單框中的項目計數，而不是以LBS_HASSTRINGS樣式建立。 |
| LB_SETCURSEL | 視需要選取字串並將其捲動至檢視。 |
| LB_SETHORIZONTALEXTENT | 設定寬度，以像素為單位，清單框可以水平捲動（可捲動的寬度）。 |
| LB_SETITEMDATA | 設定與清單框中指定專案相關聯的值。 |
| LB_SETITEMHEIGHT | 設定清單框中專案的高度，以像素為單位。 |
| LB_SETLOCALE | 設定清單框目前的地區設定。 |
| LB_SETSEL | 在多重選取清單框中選取字串。 |
| LB_SETTABSTOPS | 設定清單框中的製表位位置。 |
| LB_SETTOPINDEX | 確保清單框中的指定項目可見。 |
Notifications
| 主題 | 目錄 |
|---|---|
| LBN_DBLCLK | 通知應用程式使用者已按兩下清單框中的專案。 |
| LBN_ERRSPACE | 通知應用程式清單框無法配置足夠的記憶體以符合特定要求。 |
| LBN_KILLFOCUS | 通知應用程式清單框已失去鍵盤焦點。 |
| LBN_SELCANCEL | 通知應用程式使用者已取消清單框中的選取範圍。 |
| LBN_SELCHANGE | 通知應用程式清單框中的選取專案已變更。 |
| LBN_SETFOCUS | 通知應用程式清單框已收到鍵盤焦點。 |
| WM_CHARTOITEM | 由具有LBS_WANTKEYBOARDINPUT樣式的清單框傳送給其擁有者，以回應WM_CHAR訊息。 |
| WM_CTLCOLORLISTBOX | 在系統繪製清單方塊之前，傳送至清單框的父視窗。 透過回應此訊息，父視窗可以使用指定的顯示裝置內容句柄來設定清單框的文字和背景色彩。 |
| WM_DELETEITEM | 當清單框或下拉式方塊終結或專案被LB_DELETESTRING、LB_RESETCONTENT、CB_DELETESTRING或CB_RESETCONTENT訊息移除時，傳送至清單框或下拉式方塊的擁有者。 |
| WM_VKEYTOITEM | 由具有LBS_WANTKEYBOARDINPUT樣式的清單框傳送給其擁有者，以回應WM_KEYDOWN訊息。 |
| DL_BEGINDRAG | 通知拖曳清單框的父視窗，使用者已按兩下專案上的滑鼠左鍵。 |
| DL_CANCELDRAG | 表示使用者已按下滑鼠右鍵或按下 ESC 鍵來取消拖曳作業。 |
| DL_DRAGGING | 表示使用者拖曳專案時已移動滑鼠。 |
| DL_DROPPED | 表示使用者已透過放開滑鼠左鍵來完成拖曳作業。 |
結構
| 主題 | 目錄 |
|---|---|
| DELETEITEMSTRUCT | 包含已刪除清單框或下拉式方塊專案的相關信息。 |
| DRAGLISTINFO | 包含拖曳事件的相關信息。 DRAGLISTINFO 的指標會當做拖曳列表訊息的 lParam 參數傳遞。 |
常數
| 主題 | 目錄 |
|---|---|
| 清單框樣式 | 描述定義清單框控制件的視窗樣式。 |