通过

列表框

  • 项目

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

综述

主题 内容
有关列表框 的 描述列表框功能。
使用列表框 介绍如何执行与列表框关联的任务。

功能

主题 内容
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 参数传递。

常数

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