清單框

本節包含與清單框搭配使用之程式設計專案的相關信息。 清單框是控件視窗，其中包含用戶可從中選擇的簡單專案清單。 如需更複雜的清單，請改用 清單檢視。

綜述

主題	內容
清單框	描述清單框功能。
使用清單框	說明如何執行與清單框相關聯的工作。

功能

主題	內容
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	確保清單框中的指定項目可見。

通知

主題	內容
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 參數傳遞。

常數

主題	內容
清單框樣式	描述定義清單框控制件的視窗樣式。