# 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 | 用户移动鼠标时该事件发生。 |
示例
- ListBox 控件、AddItem 和 RemoveItem 方法、ListIndex 和 ListCount 属性示例
- ListBox 控件、BoundColumn 属性示例
- ListBox 控件、BoundColumn、ControlSource 和 RowSource 属性示例
- ListBox 控件、Column、ColumnCount 和 List 属性示例
- ListBox 控件、ColumnCount 和 ColumnWidths 属性示例
- ListBox 控件、DataObject 对象、MouseMove 事件、StartDrag 和 SetText 方法示例
- ListBox 控件、List 属性事件