列表框

本节包含与列表框一起使用的编程元素的相关信息。 列表框是一个控件窗口，包含一个用户可从中进行选择的简单项目列表。 对于更复杂的列表，请改为使用列表视图。

概述

主题	目录
关于列表框	说明列表框的功能。
使用列表框	介绍如何执行与列表框相关的任务。

函数

主题	目录
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 参数来传递。

常量

主题	目录
列表框样式	描述定义列表框控件的窗口样式。