# ListBox 列表框

用于显示一些值的列表,用户可以从中选择一个或多个值。

  • 如果 ListBox 绑定到数据源 ,则 ListBox 将所选值存储在该数据源中。

  • ListBox 可以显示为列表,也可以显示为一组 OptionButton 控件或 CheckBox 控件。

  • ListBox 的默认属性为 Value 属性。

  • ListBox 的默认事件是 Click 事件。

注意

不能在下拉列表框中放入文本。

属性
属性 说明
BackColor 规定对象的背景色。
BorderColor 指定对象的边框颜色。
BorderStyle 指定控件或窗体的边框类型。
BoundColumn 标识多列组合框或列表框中的数据的来源。
BoundValue 控件接受焦点时,包含控件的值。
Column 指定列表框或复选框中的一个或多个条目。
ColumnCount 指定列表框或组合框的显示列数。
ColumnHeads 显示列表框、组合框及接受列题注的对象中的列标题行。
ColumnWidths 指定多列的组合框或列表框中的各列的宽度。
ControlSource 标识用于设置或储存控件中 Value 属性的数据位置。ControlSource 属性可接受 Microsoft Excel 工作表区域。
ControlTipText 指定当用户将鼠标指针放在控件上但未按下时所显示的文本。
Enabled 指定一个控件能否接受焦点和响应用户产生的事件。
Font对象 定义控件或窗体所用文字的特征。
ForeColor 指定对象的前景色。
Height、Width 对象的高度和宽度,以磅为单位。
HelpContextID HelpContextID 属性将一个自定义 Microsoft Windows 帮助文件中的特定主题与一个指定的控件相关联。
IMEMode 为控件指定输入法编辑器 (IME) 的默认的运行时间模式。这个属性只用于为远东地区编写的应用程序,在其他应用程序中被忽略。
IntegralHeight 指定列表框或文本框是显示列表中全部文本行还是显示部分行。
LayoutEffect 指定在改变布局期间控件是否移动。
Left、Top 控件与所在窗体的左边或顶边之间的距离。
List 返回或设置列表框或组合框的列表条目数。
ListCount 返回控件的列表中的条目数。
ListIndex 指定当前选中的列表框或组合框条目。
ListStyle 规定列表框或组合框中的列表的外观。
Locked 指定一个控件能否被编辑。
MatchEntry 返回或设置一个值,用来表示列表框或组合框如何按用户键入的内容来搜索它的列表。
MouseIcon 为对象指定一个自定义的图标。
MousePointer 指定当用户把鼠标放到特定对象上时,所显示鼠标指针的类型。
MultiSelect 表示对象是否允许多项选择。
Name 指定一个控件或对象的名称或与 Font 对象相关的字体的名称。
Object 当新控件具有与标准属性或方法同名的属性或方法时,则覆盖相应的标准属性或方法。
OldHeight、OldWidth 返回控件先前的高度或宽度,以磅为单位。
OldLeft、OldTop 返回控件先前位置与所在窗体的左边或顶边之间的距离,以磅为单位。
Parent 返回包含指定控件、对象或集合的窗体、对象或集合的名字。
RowSource 指定为组合框或列表框提供列表的来源。
Selected 返回或设置列表框中条目的选定状态。
SpecialEffect 指定对象的外观。
TabIndex 指定单个对象在窗体 Tab 键顺序中的位置。
TabStop 指定当用户跳格到一个对象时,该对象能否获得焦点 。
Tag 存储对象的附加信息。
Text 返回或设置文本框的文本。改变组合框或列表框中选定的行。
TextAlign 定义控件中文本的对齐方式。
TextColumn 当用户在组合框或列表框中选定一行时,标识相应的列,将其保存在 Text 属性中。
TopIndex 设置和返回出现在表格最顶端位置的项目。
Value 定义某给定的控件的状态或内容。
Visible 定义一个对象是可视的还是被隐藏的。
方法
方法 说明
AddItem 对于单列的列表框或组合框,在列表中添加一项。对于多列的列表框或组合框,在列表中添加一行。
Clear 从一个对象或集合中删去所有对象。
Move 移动一个窗体或控件,或者移动 Controls 集合中的所有控件。
RemoveItem 从列表框或组合框的列表中删去一行。
ZOrder 将对象放在 Z-顺序的前面或后面。
事件
事件 说明
AfterUpdate 在通过用户界面更改了控件中的数据后,此事件发生。
BeforeDragOver 当拖放操作正在进行时该事件发生。
BeforeDropOrPaste 当用户即将在一个对象上放置或粘贴数据时,该事件发生。
BeforeUpdate 控件中的数据被改变之前该事件发生。
Change 当 Value 属性改变时该事件发生。
Click 用鼠标单击控件
DblClick 当用户指向一个对象并双击鼠标时,发生 DblClick 事件。
Enter、Exit 一个控件从同一窗体的另一个控件实际接收到焦点之前,Enter 事件发生。同一窗体中的一个控件即将把焦点转移到另一个控件之前,Exit 事件发生。
Error 当控件检测到一个错误,并且不能将该错误信息返回调用程序时该事件发生。
KeyDown、KeyUp 按下和释放某键时这两个事件依次发生。按下键时发生 KeyDown 事件,而释放键时发生 KeyUp 事件。
KeyPress 当用户按下一个 ANSI 键时该事件发生。
MouseDown、MouseUp 用户单击鼠标按键时发生。用户按下鼠标按键时发生 MouseDown 事件;用户释放鼠标按键时发生 MouseUp 事件。
MouseMove 用户移动鼠标时该事件发生。
示例