共用方式為


清單框

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

綜述

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

功能

主題 內容
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_DELETESTRINGLB_RESETCONTENTCB_DELETESTRINGCB_RESETCONTENT 訊息移除時,傳送至清單框或下拉式方塊的擁有者。
WM_VKEYTOITEM 由具有 LBS_WANTKEYBOARDINPUT 樣式的清單框傳送給其擁有者,以回應 WM_KEYDOWN 訊息。
DL_BEGINDRAG 通知拖曳清單框的父視窗,使用者已按兩下專案上的滑鼠左鍵。
DL_CANCELDRAG 表示使用者已按下滑鼠右鍵或按下 ESC 鍵來取消拖曳作業。
DL_DRAGGING 表示使用者拖曳專案時已移動滑鼠。
DL_DROPPED 表示使用者已透過放開滑鼠左鍵來完成拖曳作業。

結構

主題 內容
DELETEITEMSTRUCT 包含已刪除清單框或下拉式方塊專案的相關信息。
DRAGLISTINFO 包含拖曳事件的相關信息。 DRAGLISTINFO 的指標會當做拖曳列表訊息的 lParam 參數傳遞。

常數

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