ComboBox.AddItem 方法 (Access)

将新项添加到由指定的组合框控件显示的值列表中。

语法

表达式AddItem (索引)

表达 一个代表 ComboBox 对象的变量。

参数

名称 必需/可选 数据类型 说明
Item 必需 字符串 新添项的显示文本。
"索引" 可选 Variant 项在列表中的位置。 如果省略此参数,项就会添加到列表的尾部。

备注

指定控件的 RowSourceType 属性必须设置为 Value List。

此方法仅对窗体上的列表框或组合框控件有效。

列表项的编号从零开始。 如果 Item 参数的值与现有的项编号不对应,就会发生错误。

对于多列列表,要使用分号来分隔每列的字符串(例如,对于一个三列列表有“1010;red;large”)。 如果 Item 参数中包含的字符串个数少于控件中的列数,项就会从最左侧的列开始添加。 如果 Item 参数中包含的字符串个数多于控件中的列数,多出的字符串就会被忽略。

使用 RemoveItem 方法可以从值列表中删除某些项。

示例

下面的示例将在列表框控件中的列表的尾部添加一项。 为使函数奏效,必须将它传给代表窗体上列表框控件的 ListBox 对象和代表添加项的文本的 String 值。

Function AddItemToEnd(ctrlListBox As ListBox, _ 
 ByVal strItem As String) 
 
 ctrlListBox.AddItem Item:=strItem 
 
End Function

下面的示例将在组合框控件中的列表的开头添加一项。 为使函数奏效,必须将它传给代表窗体上组合框控件的 ComboBox 对象和代表添加项的文本的 String 值。

Function AddItemToBeginning(ctrlComboBox As ComboBox, _ 
 ByVal strItem As String) 
 
 ctrlComboBox.AddItem Item:=strItem, Index:=0 
 
End Function

支持和反馈

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