Outlook 窗体脚本) (ListBox 对象

显示一个值列表，并允许您选择其中的一个或多个值。

备注

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

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

ListBox 的默认属性是 Value 属性。

ListBox 的默认事件是 Click 事件。

不能将文本放入下拉式 ListBox 中。

ListBox 样式

ListBox 有两种表现样式可供选择。 这是由 ListStyle 属性表示的。 每种样式为用户提供了不同的方法来选择列表中的项目。

如果样式为 0，则每一项独占一行；用户可通过突出显示一行或多行来选择项目。

如果样式为 1，则每行的开头将出现 OptionButton 或 CheckBox。 使用这种样式时，用户通过单击选项按钮或复选框来选择项目。 只有当 MultiSelect 属性为 True 时，才会出现复选框。

事件

名称	说明
Click	当用户为具有多个可能值的控件明确选择一个值时发生。

方法

名称	说明
AddItem	对于单列 ListBox ， AddItem 方法向列表中添加项目。 对于多列 ListBox，此方法向列表中添加行。
Clear	删除 ListBox 中的列表中的所有条目。
RemoveItem	从 ListBox 中的列表中删除行。

属性

名称	说明
BackColor	返回或设置一个 Long 类型的值，指定对象的背景色。 读/写。
BorderColor	返回或设置一个 Long 类型的值，指定对象的边框颜色。 读/写。
BorderStyle	返回或设置一个 Integer 类型的值，指定控件的边框类型。 读/写。
BoundColumn	返回或设置一个 Variant 类型的值，该值标识多列 ListBox 中数据的源。 读/写。
列	返回或设置一个 Variant 类型的值，该值代表要加载到 ListBox 中的单个值、一列值或二维数组。 读/写。
ColumnCount	返回或设置代表要在列表框中显示的列数的 Long。 读/写。
ColumnHeads	返回或设置指定是否显示单行列标题的 Boolean。 读/写。
ColumnWidths	返回或设置一个 String，该值指定多列 ListBox 中每个列的宽度。 读/写。
Enabled	返回或设置一个 Boolean，该值指定控件是否能接收焦点并响应用户生成事件。 读/写。
ForeColor	返回或设置一个 Long 类型的值，指定对象的前景色。 读/写。
IMEMode	返回或设置一个 Integer 类型的值，指定控件的输入方法编辑器 (IME) 的默认运行时模式。 读/写。
IntegralHeight	返回或设置一个 Boolean 类型的值，该值指定 ListBox 显示列表中的整行文本还是部分行。 读/写。
List	返回或设置一个 Variant 类型的值，该值代表 ListBox 中的指定条目。 读/写。
ListCount	返回一个 Long，该值代表控件中列表条目的数量。 只读。
ListIndex	返回或设置一个 Variant 类型的值，该值代表 ListBox 中当前所选择的项目。 读/写。
ListStyle	返回或设置一个 Integer 类型的值，该值指定 ListBox 中列表的视觉外观。 读/写。
Locked	返回或设置一个 Boolean 类型的值，该值指定是否可以编辑控件。 读/写。
MatchEntry	返回或设置一个 Integer 类型的值，该值指示 ListBox 在用户键入时如何搜索其列表。 读/写。
MouseIcon	返回一个 String，该值代表要分配给控件的自定义图标的完整路径名。 只读。
MousePointer	返回或设置一个 Integer 类型的值，指定当用户将鼠标放在特定对象上时显示的指针类型。 读/写。
MultiSelect	返回或设置代表对象是否允许多选的 Integer。 读/写。
Selected	返回或设置一个 Boolean 类型的值，该值指示 ListBox 中项目的选择状态。 读/写。
SpecialEffect	返回或设置指定对象视觉外观的 Integer。 读/写。
Text	返回或设置一个 String 类型的值，该值指定在更改控件中的选定行时 ListBox 中的文本。 读/写。
TextAlign	返回或设置一个 Integer 类型的值，指定控件中文本的对齐方式。 读/写。
TextColumn	返回或设置一个 Variant 类型的值，该值标识 ListBox 中要向用户显示的列。 读/写。
TopIndex	返回或设置一个 Long，该值表示在列表的最上端位置显示的列表项的索引。 读/写。
值	返回或设置一个 Variant 类型的值，该值指定当前所选行的 BoundColumn 中的值。 读/写。

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。